Create Prepaid Account

Create Prepaid Account - Success Path

1. Create Prepaid Account API
2. Initial response value for prepaid_account_status will be PROCESSING
3. Prepaid account will go through verification and creation with partner bank
4. Webhook will indicate the prepaid_account_status is PENDING_ACTIVATION
5. Account GET will return relevant account details

Create Prepaid Account - Error Path

1. Create Prepaid Account API
2. Initial response value for prepaid_account_status will be PROCESSING
3. Prepaid account will go through verification with partner bank
4. Webhook will indicate the prepaid_account_status is NOT_CREATED and will include a prepaid_account_error field containing the verification reason.
5. Create Prepaid Account API can be called again with updated information in attempt to create the Prepaid account.

API Webhooks

A webhook Webhooks will be posted if your API account is configured for Payment Account Webhooks upon success or failure of Prepaid account creation. Webhooks are typically sent within 1 minute of the Create Account API call.

API Parameters

• payer_id

  • string
  • required
  • Payer ID

• recipient_id

  • string
  • required
  • Recipient ID

• first_name

  • string
  • Account first name

• last_name

  • string
  • Account last name

• dob

  • date
  • Date of birth

• tin

  • string
  • TIN - 9 digits, no spaces or dashes

• address

  • object
  • addressobject

Example CURL Request

curl --request POST \
     --url https://test.api.interchecks.io/api/v2/payer_id/accounts/recipient_id/prepaid \
     --header 'accept: application/json' \
     --header 'content-type: application/json'

Response Code

{
  "status": "201"
}