Manage Accounts

what are Accounts in Tango Card and why do we need them?
,,,,

Use Case

(use case here)

Get a List of Accounts Created on this platform

Use the GET {URI}/accounts endpoint to get a list of Accounts created on this platform:

FunctionPurpose
GET {URI}/accountsGet a list of Accounts created on this Platform.

The response message for this endpoint is:

  • 200 OK
  • 400 Bad request
  • 401 Unauthorized
  • 403 Forbidden

Balance Alerts

The RaaS API allows you to check an account balance at any time with GET {URI}/accounts, but it does not show the low balance alerts. We recommend building in a balance check and alert system if you anticipate the need to re-fund accounts on a regular basis.

The following example helps you observe your adjusted balance. Perform a GET {URI}/accounts call or GET {URI}/accounts{accountName} call to see the adjusted balance of your account following the order.

{
    "accountIdentifier": "accountId",
    "accountNumber": "A123456",
    "displayName": "Account Name",
    "currencyCode": "USD",
    "currentBalance": 9127.88,
    "createdAt": "2016-07-19T18:19:30.855Z",
    "status": "ACTIVE",
    "contactEmail": "[email protected]"
}

Get Details for a Specific Account

Use GET {URI}/accounts/{accountIdentifier} endpoint to get details for a specific Account under this platform:

FunctionPurpose
GET {URI}/accounts/{accountIdentifier}Get details for a specific Account on this Platform.

Here is a query parameter for when you use GET {URI}/accounts/{accountIdentifier} to get details for a specific Account on this Platform.

ParameterData TypeDescription
accountIdentifierstringThe accountIdentifier for the Account you are seeking details.

The response message for this endpoint is:

  • 200 OK
  • 400 Bad request
  • 401 Unauthorized
  • 403 Forbidden
  • 404 Not Found

The following example shows how to view your account balance using GET {URI}/accounts/accountIdentifier. Check your account balance:

{
    "accountIdentifier": "string",
    "accountNumber": "string",
    "displayName": "string",
    "currencyCode": "USD",
    "currentBalance": 7850.94,
    "createdAt": "2016-07-19T18:19:30.855Z",
    "status": "ACTIVE",
    "contactEmail": "[email protected]"
}

What’s Next