POST///
Transfers funds using an external card.
Request body
| Fields | Description |
|---|---|
| token string Optional | Unique identifier for the transfer to be created. Allowable Values: 36 char max |
| transfer_type string Required | Type of transfer to perform. Allowable Values: CARD_PULL, CARD_PUSH, CARD_DISBURSEMENT |
| card_token string Required | Unique identifier of the external card involved in the transfer. Allowable Values: Existing card token |
| source_user_token string Optional | Unique identifier of the user requesting the transfer. Optional for CARD_PUSH transfer type. Don’t include both source_user_token and source_business_token in the same request.Allowable Values: Valid user token |
| source_business_token string Optional | Unique identifier of the business requesting the transfer. Optional for CARD_PUSH transfer type. Don’t include both source_user_token and source_business_token in the same request.Allowable Values: Valid business token |
| destination_user_token string Optional | Unique identifier of the user to whom the transfer is being sent. Optional for CARD_PULL transfer type. Don’t include both destination_user_token and destination_business_token in the same request.Allowable Values: Valid user token |
| destination_business_token string Optional | Unique identifier of the business to which the transfer is being sent. Optional for CARD_PULL transfer type. Don’t include both destination_user_token and destination_business_token in the same request.Allowable Values: Valid business token |
| amount decimal Required | Amount of transfer. Allowable Values: Any number between 1 and 1000000000 |
| currency string Required | A valid three-digit ISO 4217 currency code. Allowable Values: 3 chars |
| statement_descriptor string Optional | Description of the transaction, as it will appear on the recipient’s bank statement. Allowable Values: 22 char max |
Sample request body
Card push transfer with user tokenJSON
{
"transfer_type": "CARD_PUSH",
"card_token": "ext_card_12345",
"source_user_token": "user_67890",
"amount": 100.5,
"currency": "USD",
"statement_descriptor": "GROCERY STORE"
}
JSON
{
"transfer_type": "CARD_PUSH",
"card_token": "ext_card_12345",
"source_business_token": "business_67890",
"amount": 250,
"currency": "USD",
"statement_descriptor": "ACME CORP PAYROLL"
}
JSON
{
"transfer_type": "CARD_PUSH",
"card_token": "ext_card_12345",
"amount": 150,
"currency": "USD",
"statement_descriptor": "COFFEE SHOP"
}
JSON
{
"transfer_type": "CARD_PULL",
"card_token": "ext_card_12345",
"destination_user_token": "user_67890",
"amount": 75.25,
"currency": "USD",
"statement_descriptor": "WALLET FUNDING"
}
JSON
{
"transfer_type": "CARD_PULL",
"card_token": "ext_card_12345",
"destination_business_token": "business_67890",
"amount": 500,
"currency": "USD",
"statement_descriptor": "VENDOR PAYMENT"
}
JSON
{
"transfer_type": "CARD_PULL",
"card_token": "ext_card_12345",
"amount": 200,
"currency": "USD",
"statement_descriptor": "GAS STATION"
}
JSON
{
"transfer_type": "CARD_DISBURSEMENT",
"card_token": "ext_card_12345",
"amount": 1000,
"currency": "USD",
"statement_descriptor": "CASHBACK REWARD"
}
Response body
| Fields | Description |
|---|---|
| token string Conditionally returned | Unique identifier of the transfer. Allowable Values: 36 char max |
| transfer_type string Conditionally returned | Type of transfer to perform. Allowable Values: CARD_PULL, CARD_PUSH, CARD_DISBURSEMENT |
| card_token string Conditionally returned | Unique identifier of the external card involved in the transfer. Allowable Values: 36 char max |
| source_user_token string Conditionally returned | User token that is the source for the transfer. Allowable Values: 36 char max |
| source_business_token string Conditionally returned | Business token that is the source for the transfer. Allowable Values: 36 char max |
| destination_user_token string Conditionally returned | User token that is the destination for the transfer. Allowable Values: 36 char max |
| destination_business_token string Conditionally returned | Business token that is the destination for the transfer. Allowable Values: 36 char max |
| amount decimal Conditionally returned | Amount of the transfer. Allowable Values: Any number between 0.01 and 1000000000 |
| currency string Conditionally returned | Currency of the transfer. Allowable Values: A valid three-digit ISO 4217 currency code |
| statement_descriptor string Conditionally returned | Description of the transaction, as it will appear on the recipient’s bank statement. Allowable Values: 22 char max |
| status string Conditionally returned | Processing state of the transaction. Allowable Values: CHARGEBACK, COMPLETE, PENDING, REJECTED |
| created_time datetime Conditionally returned | Date and time when the transfer was created, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| last_modified_time datetime Conditionally returned | Date and time when the transfer was updated, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |