Download OpenAPI specification:Download
The Versapay API offers operations in support of its flagship products:
Collaborative AR (formerly ARC) - accounts receivable platform with automated invoicing, effective collaboration, flexible payments and cash application to improve efficiency and customer relationships.
Importing & exporting customers, invoices, and payments.
Monitoring file based imports/batches.
Importing & exporting orders and processing order based payment transactions.
Ecommerce integrations.
PayPort - cloud based platform to electronically push and pull funds across the EFT / ACH network.
Moving funds using transactions and pre-authorized debit agreements.
A secure hosted checkout for accepting payments through your website or email.
Please contact us at support@versapay.com for support & setup of A/R invoicing integration, hosted checkout, and/or payment acceptance.
The current API version is Versapay API Reference (1.3.21)
.
Versapay commits to maintaining backward compatibility and existing API endpoints with each released version updating existing endpoints and/or introducing new endpoints.
Should Versapay require deprecation of a published API, Versapay will work with its API clients/users to confirm specific EOL/migration timelines with ample lead times, as well as endpoint migration strategies.
The UAT environment is a useful sandbox for integration testing where transaction settlements are simulated using test account numbers and test dollar amounts.
https://uat.versapay.com
Once integration testing is complete via the UAT environment, start sending your requests to the production URL to start moving money and/or integrating with Versapay.
https://secure.versapay.com
The standard rate limit is 1500 requests per minute per IP address, but Versapay reserves the right to raise or lower that limit based on network conditions. When the rate limit is exceeded, APIs will return error HTTP 1015 you are being rate limited
. Partner- or customer-specific rate limits can be established by special agreement.
Visit your account settings in UAT
(https://uat.versapay.com/account) or Production
(https://secure.versapay.com/account) to setup API credentials needed for authentication as well as webhooks to receive relevant callbacks from Versapay transaction processing.
You can generate/disable your API credentials as often as necessary for security reasons.
If you do not have an account, please contact Versapay Support for support & setup of AR invoicing integration, hosted checkout and/or payment acceptance for partner and/or API credential setup.
API requests are authenticated using API Token & Key
via HTTPS Basic Access Authentication.
Security Scheme Type | HTTPS |
---|---|
HTTPS Authorization Scheme | basic |
Simply provide the API Token & Key
values as the user
and password
parameters, using cURL for instance:
curl -u "Nvax...:UN0I..." -X POST https://secure.versapay.com/api/...
Alternatively, API requests can also be authenticated using JWT Token
via HTTPS Bearer Authentication.
Security Scheme Type | HTTPS |
---|---|
HTTP Authorization Scheme | bearer JWT |
JWT Tokens
, automatically generated alongside API Token & Key
, are displayed along with expiration in account settings as well as via authenticated /api/whoami
, see Authentication
Echo identity and account profile settings
Simply provide the JWT Token
in the authorization header, using cURL for instance:
curl -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbiI6Im54eDFaSjgzeXRNNmhtb3NGVExCIiwiZXhwIjoxNzEyOTU5NDA5fQ.adV6U1vW69Ypskt61uPL8hZ-4muvtM4FLM48QN6iCc4" -X POST https://secure.versapay.com/api/...
Visit your account settings in UAT
(https://uat.versapay.com/account) or Production
(https://secure.versapay.com/account) to setup API credentials needed for authentication as well as webhooks to receive relevant callbacks from Versapay transaction processing.
You can generate/disable your API credentials as often as necessary for security reasons.
If you do not have an account, please contact Versapay Support for support & setup of AR invoicing integration, hosted checkout and/or payment acceptance for partner and/or API credential setup.
API requests are authenticated using API Token & Key
via HTTPS Basic Access Authentication.
Security Scheme Type | HTTPS |
---|---|
HTTPS Authorization Scheme | basic |
Simply provide the API Token & Key
values as the user
and password
parameters, using cURL for instance:
curl -u "Nvax...:UN0I..." -X POST https://secure.versapay.com/api/...
Alternatively, API requests can also be authenticated using JWT Token
via HTTPS Bearer Authentication.
Security Scheme Type | HTTPS |
---|---|
HTTP Authorization Scheme | bearer JWT |
JWT Tokens
, automatically generated alongside API Token & Key
, are displayed along with expiration in account settings as well as via authenticated /api/whoami
, see Authentication
Echo identity and account profile settings
Simply provide the JWT Token
in the authorization header, using cURL for instance:
curl -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbiI6Im54eDFaSjgzeXRNNmhtb3NGVExCIiwiZXhwIjoxNzEyOTU5NDA5fQ.adV6U1vW69Ypskt61uPL8hZ-4muvtM4FLM48QN6iCc4" -X POST https://secure.versapay.com/api/...
Lists key account profile settings configured for the authenticated account
Successful Operation
Unauthorized
Production
UAT
{- "whoami": {
- "XbkkoXbkKOXbkKoXBkkOO": {
- "token": "2ABCDEFFF2ABC",
- "name": "CDS Client UAT",
- "sender_identifier": "cdscliuat",
- "jwt": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbiI6Im54eDFaSjgzeXRNNmhtb3NGVExCIiwiZXhwIjoxNzEyOTU5NDA5fQ.adV6U1vW69Ypskt61uPL8hZ-4muvtM4FLM48QN6iCc4",
- "jwt_exp": 1712959409,
- "currency": "usd",
- "preferred_language": "en",
- "business_number": "333-222-3000",
- "address_1": "PO Box 2840",
- "address_2": "",
- "postal_code": "76902",
- "city": "San Angelo",
- "province": "TX",
- "country": "US",
- "branding_partner": null,
- "branding_partner_config": null,
- "merchant_accounts": [
- {
- "token": "MA28S4KCJLAJ",
- "acceptable_cards": [
- "master",
- "visa",
- "american_express",
- "discover"
], - "currency": "usd",
- "deposit_account_routing_number": "031201360",
- "nickname": "settlement",
- "gl_account": null,
- "mid": null,
- "tid": null,
- "deposit_account_masked_number": "XXX4567",
- "deposit_routing_account_hash_function": "sha-1",
- "deposit_routing_account_hash": "cb0f864628972ad90dc08ed44e1099c7005936ca"
}, - {
- "token": "MA7NLMGDG9F4",
- "acceptable_cards": [
- "master",
- "visa",
- "american_express",
- "discover"
], - "currency": "usd",
- "deposit_account_routing_number": "031201360",
- "nickname": "settlement-2",
- "gl_account": null,
- "mid": null,
- "tid": null,
- "deposit_account_masked_number": "XXX4568",
- "deposit_routing_account_hash_function": "sha-1",
- "deposit_routing_account_hash": "52dfefa6082a07eb1689b40b99686690d1995e58"
}, - {
- "token": "MA1F8B2E87AM",
- "acceptable_cards": [
- "master",
- "visa",
- "american_express",
- "discover"
], - "currency": "usd",
- "deposit_account_routing_number": null,
- "nickname": null,
- "gl_account": null,
- "mid": null,
- "tid": null,
- "deposit_account_masked_number": "",
- "deposit_routing_account_hash_function": "sha-1",
- "deposit_routing_account_hash": "da39a3ee5e6b4b0d3255bfef95601890afd80709"
}
], - "settlement_bank_accounts": [
- {
- "routing_number": "122105278",
- "token": "BA9DZBGGJGY1",
- "account_type": "checking",
- "currency": "usd",
- "nickname": null,
- "masked_account_number": "XXXXX6789",
- "routing_account_hash_function": "sha-1",
- "routing_account_hash": "95d63eb2e03b71d1971884ec9678bcf74623b2bf",
- "address": {
- "address_1": "",
- "address_2": "",
- "city": "",
- "province": null,
- "postal_code": "",
- "country": "US"
}
}, - {
- "routing_number": "122000247",
- "token": "BA7QBIQMUMQB",
- "account_type": "checking",
- "currency": "usd",
- "nickname": null,
- "masked_account_number": "XXXXXX1152",
- "routing_account_hash_function": "sha-1",
- "routing_account_hash": "384516d914a878c8280b132d22e567dc64e67676",
- "address": {
- "address_1": "",
- "address_2": "",
- "city": "",
- "province": null,
- "postal_code": "",
- "country": "US"
}
}, - {
- "routing_number": "999999999",
- "token": "BA9K62MMRTSS",
- "account_type": "checking",
- "currency": "usd",
- "nickname": null,
- "masked_account_number": "XXXXX9999",
- "routing_account_hash_function": "sha-1",
- "routing_account_hash": "6cbe786bc66848acf8a3e539e0899809059af8a5",
- "address": {
- "address_1": "501 S 8th St",
- "address_2": "",
- "city": "Minneapolis",
- "province": "MN",
- "postal_code": "55404",
- "country": "US"
}
}
], - "terminal_processors": [
- {
- "currency": "usd",
- "token": "POS47JAV3VDE",
- "deposit_account_routing_number": "00351234",
- "nickname": "usdnick",
- "gl_account": "76001",
- "mid": "1452323678",
- "tid": "4",
- "deposit_account_masked_number": "XXXX4567",
- "deposit_routing_account_hash_function": "sha-1",
- "deposit_routing_account_hash": "da39a3ee5e6b4b0d3255bfef95601890afd80709"
}, - {
- "currency": "cad",
- "token": "POS47JAV7TGU",
- "deposit_account_routing_number": "00354321",
- "nickname": "cadnick",
- "gl_account": "76003",
- "mid": "1452343565",
- "tid": "7",
- "deposit_account_masked_number": "XXXX9876",
- "deposit_routing_account_hash_function": "sha-1",
- "deposit_routing_account_hash": "eced46533e6abaa907cd125fb91dcf76026fa02c"
}, - {
- "currency": "eur",
- "token": "POS6RPXDYYYU",
- "deposit_account_routing_number": "000000000",
- "nickname": "eurnick",
- "gl_account": "76002",
- "mid": "1452343564",
- "tid": "9",
- "deposit_account_masked_number": "XXXX5678",
- "deposit_routing_account_hash_function": "sha-1",
- "deposit_routing_account_hash": "a8105df0a9f85df19b125f4a8b4d4ea282f706af"
}
], - "gift_cards": [
- {
- "currency": "eur",
- "token": "GCP8IGHJIWM8",
- "deposit_account_routing_number": "000000000",
- "nickname": "",
- "gl_account": "",
- "mid": "",
- "tid": "",
- "deposit_account_masked_number": "",
- "deposit_routing_account_hash_function": "sha-1",
- "deposit_routing_account_hash": ""
}, - {
- "currency": "usd",
- "token": "GCP2I57ZLEDY",
- "deposit_account_routing_number": "",
- "nickname": "",
- "gl_account": "",
- "mid": "",
- "tid": "",
- "deposit_account_masked_number": "",
- "deposit_routing_account_hash_function": "sha-1",
- "deposit_routing_account_hash": ""
}, - {
- "currency": "cad",
- "token": "GCP2I57Z3ZSB",
- "deposit_account_routing_number": "",
- "nickname": "",
- "gl_account": "",
- "mid": "",
- "tid": "",
- "deposit_account_masked_number": "",
- "deposit_routing_account_hash_function": "sha-1",
- "deposit_routing_account_hash": ""
}
], - "autopay_api_enabled": false,
- "arc_payment_matc