Fund your account
You need funds to send rewards to the recipients on your platform. Before submitting your first order, you must fund your account. Only credit card funding is currently accessible via Tango API. There is a 3.5% associated fee with credit cards.
You can also fund your account free of charge in Tango portal using Automated Clearing House (ACH), wire transfer, or checks. Contact your Customer Success Manager (CSM) at success@tangocard.com for information.
Note:
API only allows for credit card funding. You can use a new credit card immediately if it’s successfully registered to your account, however, it may take up to three (3) business days to process a transaction with pending status when adding funds. See Pending status.
Fund an account
Use the following endpoint to fund an account on your platform:
| Endpoint | Description |
|---|---|
POST {URI}/creditCardDeposits | Fund an Account. |
The following body parameters are used to send data with this endpoint:
| Body params | Data type | Description |
|---|---|---|
| customerIdentifier | string | Specify the customer associated with the credit card. It must be the customer the accountIdentifier is associated with. The string must have 5-100 characters. |
| accountIdentifier | string | Specify the account this credit card is associated with. The string must have 5-100 characters. |
| creditCardToken | string | Specify the credit card token to fund with. The string must have 40 characters. |
| amount | string | Specify the amount to fund in USD. |
Funding status
When you use this endpoint to make a funding call, one of the following funding statuses are returned:
| Status | Description | Authorization | Account balance update | Charged |
|---|---|---|---|---|
| Success | The funding transaction has successfully completed and funds have been applied to the specified account. | Yes | Yes | Yes |
| Pending | The deposit has been received but the processing is not completed yet. It may be subject to review by Tango. While an authorization has been requested from the issuing bank, a capture/settlement has not yet occurred, and therefore the credit card has not yet been charged, as indicated by amountCharged in the response.It may take up to three business day for pending deposits to complete processing and transition status. | Yes | No | No |
| Declined | The funding transaction did not complete successfully and funds were not applied to the account. The credit card was not charged. If you need assistance, contact your Customer Success Manager (CSM) at success@tangocard.com for help. | Yes* | No | No |
The following example response is returned when you use this endpoint to fund your account:
{
"accountIdentifier": "string", (5-100 chars)
"amount": 1000,
"creditCardToken": "string", (40 chars)
"customerIdentifier": "string", (5-100 chars)
}
The possible response codes for this endpoint are:
- 200 OK
- 400 Bad request
- 401 Unauthorized
- 403 Forbidden
Updated about 23 hours ago