Register a new credit card

Only credit card funding is currently accessible through Tango API. If you're using a credit card to pre-fund your account, you must register it first. See how you can Register a new credit card with Tango API.

Credit cards that are successfully registered provide an activation date in the registration response. Registered credit cards are available to fund your account immediately. The first funding after registration must occur after the activation date is returned in the registration response. Any funding attempt prior to the activation date will return an error. All funding calls require the origin token returned at the time of registration.

📘

Notes:

• A maximum of 10 credit cards can be registered in an account at a time, however, we encourage you to regularly audit your credit cards on file (every 60-90 days) and delete any credit card that you do not wish to use, or has been expired.
• Credit card transactions are subject to a 3.5% processing fee.

Use the following endpoint to register a new credit card on your platform:

The following body parameters are available with this endpoint:

How to register a new credit card in the sandbox environment?

When registering a credit card in the sandbox environment, use the following card numbers for the type of card you are testing—such as Visa, MasterCard, etc. Other numbers are not supported in our Sandbox environment:

Test credit card registered with sandbox

We recommend you to test your new credit card after registering your card with Tango API sandbox. Find out the pending credit card deposit status, simulated transitions, and the expected updates within one hour after the test:

The following example shows the payload registering Visa card with sandbox:

{
  "accountIdentifier": "string", (5-100 chars)
  "billingAddress": {
    "addressLine1": "123 Street",
    "addressLine2": "Suite 456",
    "city": "Seattle",
    "country": "US",
    "emailAddress": "[email protected]",
    "firstName": "First",
    "lastName": "Last",
    "postalCode": "12345",
    "state": "WA"
  },
  "creditCard": {
    "expiration": "2025-12",
    "number": "4111111111111111",
    "verificationNumber": "123"
  },
  "customerIdentifier": "string", (5-100 chars)
  "ipAddress": "100.10.SAMPLE.10",
  "label": "Test Card"
}

Get an email receipt when registering your credit card

For the credit cards that are successfully registered after March 22, 2018, Tango sends credit card funding receipts to the primary email address included in the registration call as well as up to five additional specified contacts. A contact is defined by an emailAddress and fullName.

Contacts included with a successful registration call are reflected in the response. Contacts can also be retrieved at any time using GET {URI}/creditCards.

Receipts are only sent after a successful funding attempt has completed processing, the credit card has been charged, and the associated account balance is updated.

📘

Note:

For security reasons, the primary email address provided during credit card registration cannot be modified. To change the contacts where receipts are sent, the credit card must be deleted and re-registered with a new contact.

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:

• 201 Created
• 400 Bad Request
• 401 Unauthorized
• 403 Forbidden
• 404 Not Found
• 500 Internal Server Error
• 503 Service Unavailable