Fund an account

This Tango endpoint enables you to add funds to a specific Tango account using a credit card. This is currently the only funding method supported via the API. Funding an account via ACH, wire, and check deposits can only be done through the Tango portal.

Use case

Acme Health, a nationwide healthcare organization, runs multiple reward programs—one for employee wellness, one for patient engagement, and another for internal training incentives. Each program has its own Tango account, allowing Acme Health to track spending and maintain separate budgets. The Employee Wellness Program is about to launch a quarterly challenge, and thousands of $25 digital rewards will be issued. Before sending any rewards, Acme Health needs to ensure the “Wellness‑East” account has sufficient funds. To do this, the platform triggers the Tango API’s Fund an Account endpoint.

Endpoint

Use the following endpoint to fund an account on your platform using a credit card:

When funding an account using a credit card, you must ensure that the transaction is processed correctly and securely, using the appropriate body parameters.externalRefID is an idempotent field used to prevent accidental transfer duplication. It ensures that the same transfer is not processed multiple times. The externalRefID is returned in the funding response, funding details, and funding history.

Parameters

Body parameters are required in this endpoint to give specific, structured information to correctly process a credit‑card funding transaction. Each piece of data in the body tells Tango what to fund, for whom, with what card, for how much, and how to safely track the transaction.

The following body parameters are used to send data with this endpoint:

Funding status

Funding status refers to the state of a credit‑card funding transaction after you call this endpoint (POST {URI}/creditCardDeposits) in the Tango API. It tells you where the funding request is in its lifecycle, whether the card has been charged, and whether the funds have been applied to the account.

There are three possible funding statuses:

Examples

The following example response is returned when you use this endpoint to fund your account:

{
  "referenceDepositID": "string",
  "amount": 0,
  "amountCharged": 0,
  "feePercent": 0,
  "createdDate": "2025-04-30T16:03:34.300Z",
  "status": "string",
  "externalRefID": "string",
  "accountNumber": "string"
}

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": [
    {}
  ]
}

Response codes

The possible response codes for this endpoint are as follows. For details, see i18nkey codes and their error messages: