Secure Payments API Creating a Checking Account

General

This article talks about how to create a new bank account using the Secure Payments API. It's important to not that when you create, update, or delete payment profiles, you must use an OBO token for authorization and not the general API token.

Creating a Checking Account

Creates a new checking account and returns a token that is associated to the account. The token can be safely stored and submitted to all endpoints that work with checking accounts, without requiring re-submission of the account details. As with creating a credit card, a checking account requires an  OBO Token.

Checking accounts can be either ACH accounts (based on the USA) or EFT accounts (Canada).

Request (USA):

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'authorization: your-token' -d '{
"checking-account": {
"address": "123 Oak Lane",
"city": "Provo",
"bank_name": "Wells Fargo",
"state": "UT",
"zipcode": "90210",
"accountholder_name": "Sample Account Holder Name",
"routing_number": "123456789",
"account_number": "1234567",
"account_type": "checking",
"country": "USA"
}
}' 'https://pciwallet.simnang.com/api/checking-account'

Response:

{
"token": "CiCVDqG5QNK+ZhpBI3fNrwHkwiWdtqO5Nb1OQctzK3SzhRKnAQEBAwB4lQ6huUDSvmYaQSN3za8B5MIlnbajuTW9TkHLcyt0s4UAAAB+MHwGCSqGSIb3DQEHBqBvMG0CAQAwaAYJKoZIhvcNAQcBMB4GCWCGSAFlAwQBLjARBAygJS3P/ID82s3lVncCARCAO/78bQcHRv6XRS3xrhQn7ual1pj1HBdWTvISPwDXzOv6VrkogGFxzyfb5hZImL4LmZxFudyE+MeBU+8v.eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXUyJ9.eyJhZGRyZXNzIjoiMTIzIE9hayBMYW5lIiwidXBkYXRlZCI6MTQ1OTQ2MzExMSwiY2l0eSI6IlByb3ZvIiwiYmFua19uYW1lIjoiV2VsbHMgRmFyZ28iLCJjcmVhdGVkIjoxNDU5NDYzMTExLCJzdGF0ZSI6IlVUIiwiemlwY29kZSI6IjkwMjEwIiwiYWNjb3VudGhvbGRlcl9uYW1lIjoiU2FtcGxlIEFjY291bnQgSG9sZGVyIE5hbWUiLCJpZCI6MjAsImFkZHJlc3NfaWQiOjk1LCJ1c2VyX2lkIjo1LCJjb3VudHJ5IjoiVVNBIiwiY3VzdG9tZXJfaWQiOm51bGx9.w7aKYCSnrYyyMSIFzPCHZHF27ZburL1-75eHIj4NdLI"}

Request (Canada):

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'authorization: your-token' -d '{
"checking-account": {
"address": "123 Oak Lane",
"city": "Provo",
"bank_name": "Wells Fargo",
"state": "UT",
"zipcode": "90210",
"account_type": "checking",
"accountholder_name": "Sample Account Holder Name",
"eft_branch_number": "12345",
"eft_institution_number": "123",
"account_number": "1234567",
"country": "CAN"
}
}' 'https://pciwallet.simnang.com/api/checking-account'

Response:

{
"token": "CiCVDqG5QNK+ZhpBI3fNrwHkwiWdtqO5Nb1OQctzK3SzhRKnAQEBAwB4lQ6huUDSvmYaQSN3za8B5MIlnbajuTW9TkHLcyt0s4UAAAB+MHwGCSqGSIb3DQEHBqBvMG0CAQAwaAYJKoZIhvcNAQcBMB4GCWCGSAFlAwQBLjARBAyS/K03xVaq8dABBHUCARCAOxq6nsTzujWdDIxrPUMrOvxnFYSAGwdaSypPDezMXVjUzRGd5db77ax4Efki9rRSdTaAy5sENfAmV2Ft.eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXUyJ9.eyJhZGRyZXNzIjoiMTIzIE9hayBMYW5lIiwidXBkYXRlZCI6MTQ1OTQ2MzI5MiwiY2l0eSI6IlByb3ZvIiwiYmFua19uYW1lIjoiV2VsbHMgRmFyZ28iLCJjcmVhdGVkIjoxNDU5NDYzMjkyLCJzdGF0ZSI6IlVUIiwiemlwY29kZSI6IjkwMjEwIiwiYWNjb3VudGhvbGRlcl9uYW1lIjoiU2FtcGxlIEFjY291bnQgSG9sZGVyIE5hbWUiLCJpZCI6MjEsImFkZHJlc3NfaWQiOjk3LCJ1c2VyX2lkIjo1LCJjb3VudHJ5IjoiQ0FOIiwiY3VzdG9tZXJfaWQiOm51bGx9.cuUDf2FLnUkqgOC8ViYm3DBBdRQkgNQyr40JEUYvzUs"}


How did we do?


Powered by HelpDocs (opens in a new tab)