prepaid accounts
Create Prepaid Account - Success Path
- Create Prepaid Account API
- Initial response value for
prepaid_account_statuswill bePROCESSING - Prepaid account will go through verification and creation with partner bank
- Webhook will indicate the
prepaid_account_statusisPENDING_ACTIVATION - Account
GETwill return relevant account details
Create Prepaid Account - Error Path
- Create Prepaid Account API
- Initial response value for
prepaid_account_statuswill bePROCESSING - Prepaid account will go through verification with partner bank
- Webhook will indicate the
prepaid_account_statusisNOT_CREATEDand will include aprepaid_account_errorfield containing the verification reason. - Create Prepaid Account API can be called again with updated information in an 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 IDrecipient_id
string
required
Recipient IDfirst_name
string
Account first namelast_name
string
Account last namedob
date
Date of birthtin
string
TIN - 9 digits, no spaces or dashesaddress
object
address object
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
{
"status": "201",
"message": "Result"
}