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)
}

Here's an example payload for when you receive an error:

{
  "timestamp": "2025-02-21T23:23:13.930Z",
  "requestId": "string",
  "path": "string",
  "httpCode": 0,
  "httpPhrase": "string",
  "i18nKey": "string",
  "message": "The error message will show here for error codes ",
  "errors": [
    {}
  ]
}

The possible response codes for this endpoint are:

200 OK
400 Bad request
401 Unauthorized
403 Forbidden
500 Internal Server Error
503 Service Unavailable