Create an account under a specific customer

Use the POST {URI}/customers/{customerIdentifier}/accounts endpoint to create an account under a specific customer on this platform.

EndpointPurpose
POST {URI}/customers/{customerIdentifier}/accountsCreate an account under a specific customer on this platform.

Here are the list of parameters for when you use POST {URI}/customers/{customerIdentifier}/accounts to create an account under specific customer on your platform:

Path parameterData typeDescription
customerIdentifierstringA unique identifier for the customer under which you are creating a new account. The string must have 5-100 characters.
Body parameterData typeDescription
accountIdentifierstringA unique identifier for this account. It must be between 5-100 characters and accepts the following: -0-9a-zA-Z in any sequence.
displayNamestringA friendly name for this account. The string may have up to 100 characters.
contactEmailstringAn email address for a designated representative for this account. The string may have up to 100 characters.
currencyCodestringThe only currency accepted by this account for deposits/withdraws is CAD, EUR, GBP, or USD. Only one currency can be specified. Currency can never be changed. The currency defaults to USD if no currency is specified.
fundingNotificationarrays of objectSend funding notification emails to the address(es).
- emailAddressstring(Optional) The email address used to send funding notifications to for this account.

The following example shows the response for when you use POST {URI}/customers/{customerIdentifier}/accounts to create an account under specific customer on your platform. The account identifier must be lowercase:

{
  "accountIdentifier": "string", (5-100 chars)
  "displayName": "string", (100 chars)
  "contactEmail": "string", (100 chars)
  "currencyCode": "USD", (3 chars)
  "fundingNotification": [
    {
      "emailAddress": "string"
    }
  ]
}

The response message for this endpoint is:

  • 201 Created
  • 400 Bad request
  • 401 Unauthorized
  • 403 Forbidden
  • 409 Conflict, Duplicate Exist

Rewards as a Service™ and the RaaS® API are provided by Tango Card, Inc. © 2024 Tango Card, Inc.