# Card Push Transfers > Card Push Transfers send funds to a recipient's payment card in real-time. [Events](https://increase.com/documentation/events.md) will be generated for this resource. The possible event categories are: `card_push_transfer.created` and `card_push_transfer.updated`. ## The Card Push Transfer object ### Example ```json { "acceptance": null, "account_id": "account_in71c4amph0vgo2qllky", "approval": null, "business_application_identifier": "funds_disbursement", "cancellation": null, "card_token_id": "outbound_card_token_zlt0ml6youq3q7vcdlg0", "created_at": "2020-01-31T23:59:59Z", "created_by": { "category": "user", "user": { "email": "user@example.com" } }, "decline": null, "id": "outbound_card_push_transfer_e0z9rdpamraczh4tvwye", "idempotency_key": null, "merchant_category_code": "1234", "merchant_city_name": "New York", "merchant_name": "Acme Corp", "merchant_name_prefix": "Acme", "merchant_postal_code": "10045", "merchant_state": "NY", "presentment_amount": { "currency": "USD", "value": "12.34" }, "recipient_name": "Ian Crease", "route": "visa", "sender_address_city": "New York", "sender_address_line1": "33 Liberty Street", "sender_address_postal_code": "10045", "sender_address_state": "NY", "sender_name": "Ian Crease", "source_account_number_id": "account_number_v18nkfqm6afpsrvy82b2", "status": "pending_submission", "submission": null, "type": "card_push_transfer" } ``` ### Attributes - `acceptance` (dictionary, nullable) If the transfer is accepted by the recipient bank, this will contain supplemental details. - `acceptance.accepted_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the transfer was accepted by the issuing bank. - `acceptance.authorization_identification_response` (string) The authorization identification response from the issuing bank. - `acceptance.card_verification_value2_result` (enum, nullable) The result of the Card Verification Value 2 match. Cases: * `match` (The Card Verification Value 2 (CVV2) matches the expected value.) * `no_match` (The Card Verification Value 2 (CVV2) does not match the expected value.) - `acceptance.network_transaction_identifier` (string, nullable) A unique identifier for the transaction on the card network. - `acceptance.settlement_amount` (integer) The transfer amount in USD cents. - `account_id` (string) The Account from which the transfer was sent. - `approval` (dictionary, nullable) If your account requires approvals for transfers and the transfer was approved, this will contain details of the approval. - `approval.approved_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the transfer was approved. - `approval.approved_by` (string, nullable) If the Transfer was approved by a user in the dashboard, the email address of that user. - `business_application_identifier` (enum) The Business Application Identifier describes the type of transaction being performed. Your program must be approved for the specified Business Application Identifier in order to use it. Cases: * `account_to_account` (Account to Account) * `business_to_business` (Business to Business) * `money_transfer_bank_initiated` (Money Transfer Bank Initiated) * `non_card_bill_payment` (Non-Card Bill Payment) * `consumer_bill_payment` (Consumer Bill Payment) * `card_bill_payment` (Card Bill Payment) * `funds_disbursement` (Funds Disbursement) * `funds_transfer` (Funds Transfer) * `loyalty_and_offers` (Loyalty and Offers) * `merchant_disbursement` (Merchant Disbursement) * `merchant_payment` (Merchant Payment) * `person_to_person` (Person to Person) * `top_up` (Top Up) * `wallet_transfer` (Wallet Transfer) - `cancellation` (dictionary, nullable) If your account requires approvals for transfers and the transfer was not approved, this will contain details of the cancellation. - `cancellation.canceled_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Transfer was canceled. - `cancellation.canceled_by` (string, nullable) If the Transfer was canceled by a user in the dashboard, the email address of that user. - `card_token_id` (string) The ID of the Card Token that was used to validate the card. - `created_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the transfer was created. - `created_by` (dictionary, nullable) What object created the transfer, either via the API or the dashboard. - `created_by.api_key` (dictionary, nullable) If present, details about the API key that created the transfer. - `created_by.api_key.description` (string, nullable) The description set for the API key when it was created. - `created_by.category` (enum) The type of object that created this transfer. Cases: * `api_key` (An API key. Details will be under the `api_key` object.) * `oauth_application` (An OAuth application you connected to Increase. Details will be under the `oauth_application` object.) * `user` (A User in the Increase dashboard. Details will be under the `user` object.) - `created_by.oauth_application` (dictionary, nullable) If present, details about the OAuth Application that created the transfer. - `created_by.oauth_application.name` (string) The name of the OAuth Application. - `created_by.user` (dictionary, nullable) If present, details about the User that created the transfer. - `created_by.user.email` (string) The email address of the User. - `decline` (dictionary, nullable) If the transfer is rejected by the card network or the destination financial institution, this will contain supplemental details. - `decline.declined_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the transfer declined. - `decline.network_transaction_identifier` (string, nullable) A unique identifier for the transaction on the card network. - `decline.reason` (enum) The reason why the transfer was declined. Cases: * `do_not_honor` (The card issuer has declined the transaction without providing a specific reason.) * `activity_count_limit_exceeded` (The number of transactions for the card has exceeded the limit set by the issuer.) * `refer_to_card_issuer` (The card issuer requires the cardholder to contact them for further information regarding the transaction.) * `refer_to_card_issuer_special_condition` (The card issuer requires the cardholder to contact them due to a special condition related to the transaction.) * `invalid_merchant` (The merchant is not valid for this transaction.) * `pick_up_card` (The card should be retained by the terminal.) * `error` (An error occurred during processing of the transaction.) * `pick_up_card_special` (The card should be retained by the terminal due to a special condition.) * `invalid_transaction` (The transaction is invalid and cannot be processed.) * `invalid_amount` (The amount of the transaction is invalid.) * `invalid_account_number` (The account number provided is invalid.) * `no_such_issuer` (The issuer of the card could not be found.) * `re_enter_transaction` (The transaction should be re-entered for processing.) * `no_credit_account` (There is no credit account associated with the card.) * `pick_up_card_lost` (The card should be retained by the terminal because it has been reported lost.) * `pick_up_card_stolen` (The card should be retained by the terminal because it has been reported stolen.) * `closed_account` (The account associated with the card has been closed.) * `insufficient_funds` (There are insufficient funds in the account to complete the transaction.) * `no_checking_account` (There is no checking account associated with the card.) * `no_savings_account` (There is no savings account associated with the card.) * `expired_card` (The card has expired and cannot be used for transactions.) * `transaction_not_permitted_to_cardholder` (The transaction is not permitted for this cardholder.) * `transaction_not_allowed_at_terminal` (The transaction is not allowed at this terminal.) * `transaction_not_supported_or_blocked_by_issuer` (The transaction is not supported or has been blocked by the issuer.) * `suspected_fraud` (The transaction has been flagged as suspected fraud and cannot be processed.) * `activity_amount_limit_exceeded` (The amount of activity on the card has exceeded the limit set by the issuer.) * `restricted_card` (The card has restrictions that prevent it from being used for this transaction.) * `security_violation` (A security violation has occurred, preventing the transaction from being processed.) * `transaction_does_not_fulfill_anti_money_laundering_requirement` (The transaction does not meet the anti-money laundering requirements set by the issuer.) * `blocked_by_cardholder` (The transaction was blocked by the cardholder.) * `blocked_first_use` (The first use of the card has been blocked by the issuer.) * `credit_issuer_unavailable` (The credit issuer is currently unavailable to process the transaction.) * `negative_card_verification_value_results` (The card verification value (CVV) results were negative, indicating a potential issue with the card.) * `issuer_unavailable` (The issuer of the card is currently unavailable to process the transaction.) * `financial_institution_cannot_be_found` (The financial institution associated with the card could not be found.) * `transaction_cannot_be_completed` (The transaction cannot be completed due to an unspecified reason.) * `duplicate_transaction` (The transaction is a duplicate of a previous transaction and cannot be processed again.) * `system_malfunction` (A system malfunction occurred, preventing the transaction from being processed.) * `additional_customer_authentication_required` (Additional customer authentication is required to complete the transaction.) * `surcharge_amount_not_permitted` (The surcharge amount applied to the transaction is not permitted by the issuer.) * `decline_for_cvv2_failure` (The transaction was declined due to a failure in verifying the CVV2 code.) * `stop_payment_order` (A stop payment order has been placed on this transaction.) * `revocation_of_authorization_order` (An order has been placed to revoke authorization for this transaction.) * `revocation_of_all_authorizations_order` (An order has been placed to revoke all authorizations for this cardholder.) * `unable_to_locate_record` (The record associated with the transaction could not be located.) * `file_is_temporarily_unavailable` (The file needed for the transaction is temporarily unavailable.) * `incorrect_pin` (The PIN entered for the transaction is incorrect.) * `allowable_number_of_pin_entry_tries_exceeded` (The allowable number of PIN entry tries has been exceeded.) * `unable_to_locate_previous_message` (The previous message associated with the transaction could not be located.) * `pin_error_found` (An error was found with the PIN associated with the transaction.) * `cannot_verify_pin` (The PIN associated with the transaction could not be verified.) * `verification_data_failed` (The verification data associated with the transaction has failed.) * `surcharge_amount_not_supported_by_debit_network_issuer` (The surcharge amount is not supported by the debit network issuer.) * `cash_service_not_available` (Cash service is not available for this transaction.) * `cashback_request_exceeds_issuer_limit` (The cashback request exceeds the issuer limit.) * `transaction_amount_exceeds_pre_authorized_approval_amount` (The transaction amount exceeds the pre-authorized approval amount.) * `transaction_does_not_qualify_for_visa_pin` (The transaction does not qualify for Visa PIN processing.) * `offline_declined` (The transaction was declined offline.) * `unable_to_go_online` (The terminal was unable to go online to process the transaction.) * `valid_account_but_amount_not_supported` (The account is valid but the transaction amount is not supported.) * `invalid_use_of_merchant_category_code_correct_and_reattempt` (The merchant category code was used incorrectly; correct it and reattempt the transaction.) * `card_authentication_failed` (The card authentication process has failed.) - `id` (string) The Card Push Transfer's identifier. - `idempotency_key` (string, nullable) The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys). - `merchant_category_code` (string) The merchant category code (MCC) of the merchant (generally your business) sending the transfer. This is a four-digit code that describes the type of business or service provided by the merchant. Your program must be approved for the specified MCC in order to use it. - `merchant_city_name` (string) The city name of the merchant (generally your business) sending the transfer. - `merchant_name` (string) The merchant name shows up as the statement descriptor for the transfer. This is typically the name of your business or organization. - `merchant_name_prefix` (string) For certain Business Application Identifiers, the statement descriptor is `merchant_name_prefix*sender_name`, where the `merchant_name_prefix` is a one to four character prefix that identifies the merchant. - `merchant_postal_code` (string) The postal code of the merchant (generally your business) sending the transfer. - `merchant_state` (string) The state of the merchant (generally your business) sending the transfer. - `presentment_amount` (dictionary) The amount that was transferred. The receiving bank will have converted this to the cardholder's currency. The amount that is applied to your Increase account matches the currency of your account. - `presentment_amount.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code. Cases: * `AFN` (AFN) * `EUR` (EUR) * `ALL` (ALL) * `DZD` (DZD) * `USD` (USD) * `AOA` (AOA) * `ARS` (ARS) * `AMD` (AMD) * `AWG` (AWG) * `AUD` (AUD) * `AZN` (AZN) * `BSD` (BSD) * `BHD` (BHD) * `BDT` (BDT) * `BBD` (BBD) * `BYN` (BYN) * `BZD` (BZD) * `BMD` (BMD) * `INR` (INR) * `BTN` (BTN) * `BOB` (BOB) * `BOV` (BOV) * `BAM` (BAM) * `BWP` (BWP) * `NOK` (NOK) * `BRL` (BRL) * `BND` (BND) * `BGN` (BGN) * `BIF` (BIF) * `CVE` (CVE) * `KHR` (KHR) * `CAD` (CAD) * `KYD` (KYD) * `CLP` (CLP) * `CLF` (CLF) * `CNY` (CNY) * `COP` (COP) * `COU` (COU) * `KMF` (KMF) * `CDF` (CDF) * `NZD` (NZD) * `CRC` (CRC) * `CUP` (CUP) * `CZK` (CZK) * `DKK` (DKK) * `DJF` (DJF) * `DOP` (DOP) * `EGP` (EGP) * `SVC` (SVC) * `ERN` (ERN) * `SZL` (SZL) * `ETB` (ETB) * `FKP` (FKP) * `FJD` (FJD) * `GMD` (GMD) * `GEL` (GEL) * `GHS` (GHS) * `GIP` (GIP) * `GTQ` (GTQ) * `GBP` (GBP) * `GNF` (GNF) * `GYD` (GYD) * `HTG` (HTG) * `HNL` (HNL) * `HKD` (HKD) * `HUF` (HUF) * `ISK` (ISK) * `IDR` (IDR) * `IRR` (IRR) * `IQD` (IQD) * `ILS` (ILS) * `JMD` (JMD) * `JPY` (JPY) * `JOD` (JOD) * `KZT` (KZT) * `KES` (KES) * `KPW` (KPW) * `KRW` (KRW) * `KWD` (KWD) * `KGS` (KGS) * `LAK` (LAK) * `LBP` (LBP) * `LSL` (LSL) * `ZAR` (ZAR) * `LRD` (LRD) * `LYD` (LYD) * `CHF` (CHF) * `MOP` (MOP) * `MKD` (MKD) * `MGA` (MGA) * `MWK` (MWK) * `MYR` (MYR) * `MVR` (MVR) * `MRU` (MRU) * `MUR` (MUR) * `MXN` (MXN) * `MXV` (MXV) * `MDL` (MDL) * `MNT` (MNT) * `MAD` (MAD) * `MZN` (MZN) * `MMK` (MMK) * `NAD` (NAD) * `NPR` (NPR) * `NIO` (NIO) * `NGN` (NGN) * `OMR` (OMR) * `PKR` (PKR) * `PAB` (PAB) * `PGK` (PGK) * `PYG` (PYG) * `PEN` (PEN) * `PHP` (PHP) * `PLN` (PLN) * `QAR` (QAR) * `RON` (RON) * `RUB` (RUB) * `RWF` (RWF) * `SHP` (SHP) * `WST` (WST) * `STN` (STN) * `SAR` (SAR) * `RSD` (RSD) * `SCR` (SCR) * `SLE` (SLE) * `SGD` (SGD) * `SBD` (SBD) * `SOS` (SOS) * `SSP` (SSP) * `LKR` (LKR) * `SDG` (SDG) * `SRD` (SRD) * `SEK` (SEK) * `CHE` (CHE) * `CHW` (CHW) * `SYP` (SYP) * `TWD` (TWD) * `TJS` (TJS) * `TZS` (TZS) * `THB` (THB) * `TOP` (TOP) * `TTD` (TTD) * `TND` (TND) * `TRY` (TRY) * `TMT` (TMT) * `UGX` (UGX) * `UAH` (UAH) * `AED` (AED) * `USN` (USN) * `UYU` (UYU) * `UYI` (UYI) * `UYW` (UYW) * `UZS` (UZS) * `VUV` (VUV) * `VES` (VES) * `VED` (VED) * `VND` (VND) * `YER` (YER) * `ZMW` (ZMW) * `ZWG` (ZWG) - `presentment_amount.value` (string) The amount value represented as a string containing a decimal number in major units (so e.g., "12.34" for $12.34). - `recipient_name` (string) The name of the funds recipient. - `route` (enum) The card network route used for the transfer. Cases: * `visa` (Visa and Interlink) * `mastercard` (Mastercard and Maestro) - `sender_address_city` (string) The city of the sender. - `sender_address_line1` (string) The address line 1 of the sender. - `sender_address_postal_code` (string) The postal code of the sender. - `sender_address_state` (string) The state of the sender. - `sender_name` (string) The name of the funds originator. - `source_account_number_id` (string) The Account Number the recipient will see as having sent the transfer. - `status` (enum) The lifecycle status of the transfer. Cases: * `pending_approval` (The transfer is pending approval.) * `canceled` (The transfer has been canceled.) * `pending_reviewing` (The transfer is pending review by Increase.) * `requires_attention` (The transfer requires attention from an Increase operator.) * `pending_submission` (The transfer is queued to be submitted to the card network.) * `submitted` (The transfer has been submitted and is pending a response from the card network.) * `complete` (The transfer has been sent successfully and is complete.) * `declined` (The transfer was declined by the network or the recipient's bank.) - `submission` (dictionary, nullable) After the transfer is submitted to the card network, this will contain supplemental details. - `submission.retrieval_reference_number` (string) A 12-digit retrieval reference number that identifies the transfer. Usually a combination of a timestamp and the trace number. - `submission.sender_reference` (string) A unique reference for the transfer. - `submission.submitted_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the transfer was submitted to the card network. - `submission.trace_number` (string) A 6-digit trace number that identifies the transfer within a small window of time. - `type` (string) A constant representing the object's type. For this resource it will always be `card_push_transfer`. ## List Card Push Transfers GET /card_push_transfers ### Example ```curl curl \ --url "${INCREASE_URL}/card_push_transfers?account_id=account_in71c4amph0vgo2qllky" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" ``` ### Query Parameters - `cursor` (string, optional) Return the page of entries after this one. - `limit` (integer, optional) Limit the size of the list that is returned. The default (and maximum) is 100 objects. - `account_id` (string, optional) Filter Card Push Transfers to ones belonging to the specified Account. - `created_at.after` (string, optional) Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp. - `created_at.before` (string, optional) Return results before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp. - `created_at.on_or_after` (string, optional) Return results on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp. - `created_at.on_or_before` (string, optional) Return results on or before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp. - `status.in` (array of enums, optional) Filter Card Push Transfers by status. For GET requests, this should be encoded as a comma-delimited string, such as `?in=one,two,three`. Cases: * `pending_approval` (The transfer is pending approval.) * `canceled` (The transfer has been canceled.) * `pending_reviewing` (The transfer is pending review by Increase.) * `requires_attention` (The transfer requires attention from an Increase operator.) * `pending_submission` (The transfer is queued to be submitted to the card network.) * `submitted` (The transfer has been submitted and is pending a response from the card network.) * `complete` (The transfer has been sent successfully and is complete.) * `declined` (The transfer was declined by the network or the recipient's bank.) - `idempotency_key` (string, optional) Filter records to the one with the specified `idempotency_key` you chose for that object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys). ### Returns a Card Push Transfer List object: ```json { "data": [ { "acceptance": null, "account_id": "account_in71c4amph0vgo2qllky", "approval": null, "business_application_identifier": "funds_disbursement", "cancellation": null, "card_token_id": "outbound_card_token_zlt0ml6youq3q7vcdlg0", "created_at": "2020-01-31T23:59:59Z", "created_by": { "category": "user", "user": { "email": "user@example.com" } }, "decline": null, "id": "outbound_card_push_transfer_e0z9rdpamraczh4tvwye", "idempotency_key": null, "merchant_category_code": "1234", "merchant_city_name": "New York", "merchant_name": "Acme Corp", "merchant_name_prefix": "Acme", "merchant_postal_code": "10045", "merchant_state": "NY", "presentment_amount": { "currency": "USD", "value": "12.34" }, "recipient_name": "Ian Crease", "route": "visa", "sender_address_city": "New York", "sender_address_line1": "33 Liberty Street", "sender_address_postal_code": "10045", "sender_address_state": "NY", "sender_name": "Ian Crease", "source_account_number_id": "account_number_v18nkfqm6afpsrvy82b2", "status": "pending_submission", "submission": null, "type": "card_push_transfer" } ], "next_cursor": "v57w5d" } ``` ## Create a Card Push Transfer POST /card_push_transfers ### Example ```curl curl -X "POST" \ --url "${INCREASE_URL}/card_push_transfers" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" \ -H "Content-Type: application/json" \ -d $'{ "business_application_identifier": "funds_disbursement", "card_token_id": "outbound_card_token_zlt0ml6youq3q7vcdlg0", "merchant_category_code": "1234", "merchant_city_name": "New York", "merchant_name": "Acme Corp", "merchant_name_prefix": "Acme", "merchant_postal_code": "10045", "merchant_state": "NY", "presentment_amount": { "currency": "USD", "value": "1234.56" }, "recipient_name": "Ian Crease", "sender_address_city": "New York", "sender_address_line1": "33 Liberty Street", "sender_address_postal_code": "10045", "sender_address_state": "NY", "sender_name": "Ian Crease", "source_account_number_id": "account_number_v18nkfqm6afpsrvy82b2" }' ``` ### Body Parameters - `business_application_identifier` (enum, required) The Business Application Identifier describes the type of transaction being performed. Your program must be approved for the specified Business Application Identifier in order to use it. Cases: * `account_to_account` (Account to Account) * `business_to_business` (Business to Business) * `money_transfer_bank_initiated` (Money Transfer Bank Initiated) * `non_card_bill_payment` (Non-Card Bill Payment) * `consumer_bill_payment` (Consumer Bill Payment) * `card_bill_payment` (Card Bill Payment) * `funds_disbursement` (Funds Disbursement) * `funds_transfer` (Funds Transfer) * `loyalty_and_offers` (Loyalty and Offers) * `merchant_disbursement` (Merchant Disbursement) * `merchant_payment` (Merchant Payment) * `person_to_person` (Person to Person) * `top_up` (Top Up) * `wallet_transfer` (Wallet Transfer) - `card_token_id` (string, required) The Increase identifier for the Card Token that represents the card number you're pushing funds to. - `merchant_category_code` (string, required) The merchant category code (MCC) of the merchant (generally your business) sending the transfer. This is a four-digit code that describes the type of business or service provided by the merchant. Your program must be approved for the specified MCC in order to use it. - `merchant_city_name` (string, required) The city name of the merchant (generally your business) sending the transfer. - `merchant_legal_business_name` (string, optional) The legal business name of the merchant (generally your business) sending the transfer. Required if the card is issued in Canada. - `merchant_name` (string, required) The merchant name shows up as the statement descriptor for the transfer. This is typically the name of your business or organization. - `merchant_name_prefix` (string, required) For certain Business Application Identifiers, the statement descriptor is `merchant_name_prefix*sender_name`, where the `merchant_name_prefix` is a one to four character prefix that identifies the merchant. - `merchant_postal_code` (string, required) The postal code of the merchant (generally your business) sending the transfer. - `merchant_state` (string, required) The state of the merchant (generally your business) sending the transfer. - `merchant_street_address` (string, optional) The street address of the merchant (generally your business) sending the transfer. Required if the card is issued in Canada. - `presentment_amount` (dictionary, required) The amount to transfer. The receiving bank will convert this to the cardholder's currency. The amount that is applied to your Increase account matches the currency of your account. - `presentment_amount.currency` (enum, required) The ISO 4217 currency code representing the currency of the amount. Cases: * `AFN` (AFN) * `EUR` (EUR) * `ALL` (ALL) * `DZD` (DZD) * `USD` (USD) * `AOA` (AOA) * `ARS` (ARS) * `AMD` (AMD) * `AWG` (AWG) * `AUD` (AUD) * `AZN` (AZN) * `BSD` (BSD) * `BHD` (BHD) * `BDT` (BDT) * `BBD` (BBD) * `BYN` (BYN) * `BZD` (BZD) * `BMD` (BMD) * `INR` (INR) * `BTN` (BTN) * `BOB` (BOB) * `BOV` (BOV) * `BAM` (BAM) * `BWP` (BWP) * `NOK` (NOK) * `BRL` (BRL) * `BND` (BND) * `BGN` (BGN) * `BIF` (BIF) * `CVE` (CVE) * `KHR` (KHR) * `CAD` (CAD) * `KYD` (KYD) * `CLP` (CLP) * `CLF` (CLF) * `CNY` (CNY) * `COP` (COP) * `COU` (COU) * `KMF` (KMF) * `CDF` (CDF) * `NZD` (NZD) * `CRC` (CRC) * `CUP` (CUP) * `CZK` (CZK) * `DKK` (DKK) * `DJF` (DJF) * `DOP` (DOP) * `EGP` (EGP) * `SVC` (SVC) * `ERN` (ERN) * `SZL` (SZL) * `ETB` (ETB) * `FKP` (FKP) * `FJD` (FJD) * `GMD` (GMD) * `GEL` (GEL) * `GHS` (GHS) * `GIP` (GIP) * `GTQ` (GTQ) * `GBP` (GBP) * `GNF` (GNF) * `GYD` (GYD) * `HTG` (HTG) * `HNL` (HNL) * `HKD` (HKD) * `HUF` (HUF) * `ISK` (ISK) * `IDR` (IDR) * `IRR` (IRR) * `IQD` (IQD) * `ILS` (ILS) * `JMD` (JMD) * `JPY` (JPY) * `JOD` (JOD) * `KZT` (KZT) * `KES` (KES) * `KPW` (KPW) * `KRW` (KRW) * `KWD` (KWD) * `KGS` (KGS) * `LAK` (LAK) * `LBP` (LBP) * `LSL` (LSL) * `ZAR` (ZAR) * `LRD` (LRD) * `LYD` (LYD) * `CHF` (CHF) * `MOP` (MOP) * `MKD` (MKD) * `MGA` (MGA) * `MWK` (MWK) * `MYR` (MYR) * `MVR` (MVR) * `MRU` (MRU) * `MUR` (MUR) * `MXN` (MXN) * `MXV` (MXV) * `MDL` (MDL) * `MNT` (MNT) * `MAD` (MAD) * `MZN` (MZN) * `MMK` (MMK) * `NAD` (NAD) * `NPR` (NPR) * `NIO` (NIO) * `NGN` (NGN) * `OMR` (OMR) * `PKR` (PKR) * `PAB` (PAB) * `PGK` (PGK) * `PYG` (PYG) * `PEN` (PEN) * `PHP` (PHP) * `PLN` (PLN) * `QAR` (QAR) * `RON` (RON) * `RUB` (RUB) * `RWF` (RWF) * `SHP` (SHP) * `WST` (WST) * `STN` (STN) * `SAR` (SAR) * `RSD` (RSD) * `SCR` (SCR) * `SLE` (SLE) * `SGD` (SGD) * `SBD` (SBD) * `SOS` (SOS) * `SSP` (SSP) * `LKR` (LKR) * `SDG` (SDG) * `SRD` (SRD) * `SEK` (SEK) * `CHE` (CHE) * `CHW` (CHW) * `SYP` (SYP) * `TWD` (TWD) * `TJS` (TJS) * `TZS` (TZS) * `THB` (THB) * `TOP` (TOP) * `TTD` (TTD) * `TND` (TND) * `TRY` (TRY) * `TMT` (TMT) * `UGX` (UGX) * `UAH` (UAH) * `AED` (AED) * `USN` (USN) * `UYU` (UYU) * `UYI` (UYI) * `UYW` (UYW) * `UZS` (UZS) * `VUV` (VUV) * `VES` (VES) * `VED` (VED) * `VND` (VND) * `YER` (YER) * `ZMW` (ZMW) * `ZWG` (ZWG) - `presentment_amount.value` (string, required) The amount value as a decimal string in the currency's major unit. For example, for USD, '1234.56' represents 1234 dollars and 56 cents. For JPY, '1234' represents 1234 yen. A currency with minor units requires at least one decimal place and supports up to the number of decimal places defined by the currency's minor units. A currency without minor units does not support any decimal places. - `recipient_address_city` (string, optional) The city of the recipient. Required if the card is issued in Canada. - `recipient_address_line1` (string, optional) The first line of the recipient's address. Required if the card is issued in Canada. - `recipient_address_postal_code` (string, optional) The postal code of the recipient. Required if the card is issued in Canada. - `recipient_address_state` (string, optional) The state or province of the recipient. Required if the card is issued in Canada. - `recipient_name` (string, required) The name of the funds recipient. - `require_approval` (boolean, optional) Whether the transfer requires explicit approval via the dashboard or API. - `sender_address_city` (string, required) The city of the sender. - `sender_address_line1` (string, required) The address line 1 of the sender. - `sender_address_postal_code` (string, required) The postal code of the sender. - `sender_address_state` (string, required) The state of the sender. - `sender_name` (string, required) The name of the funds originator. - `source_account_number_id` (string, required) The identifier of the Account Number from which to send the transfer. ## Retrieve a Card Push Transfer GET /card_push_transfers/{card_push_transfer_id} ### Example ```curl curl \ --url "${INCREASE_URL}/card_push_transfers/outbound_card_push_transfer_e0z9rdpamraczh4tvwye" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" ``` ### Path Parameters - `card_push_transfer_id` (string, required) The identifier of the Card Push Transfer. ## Approve a Card Push Transfer POST /card_push_transfers/{card_push_transfer_id}/approve > Approves a Card Push Transfer in a pending_approval state. ### Example ```curl curl -X "POST" \ --url "${INCREASE_URL}/card_push_transfers/outbound_card_push_transfer_e0z9rdpamraczh4tvwye/approve" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" ``` ### Path Parameters - `card_push_transfer_id` (string, required) The identifier of the Card Push Transfer to approve. ## Cancel a pending Card Push Transfer POST /card_push_transfers/{card_push_transfer_id}/cancel > Cancels a Card Push Transfer in a pending_approval state. ### Example ```curl curl -X "POST" \ --url "${INCREASE_URL}/card_push_transfers/outbound_card_push_transfer_e0z9rdpamraczh4tvwye/cancel" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" ``` ### Path Parameters - `card_push_transfer_id` (string, required) The identifier of the pending Card Push Transfer to cancel.