Guides

Payment Guides

Integrate with ArtsPay to start accepting payments online and in person, embed into your own platform, and find the ArtsPay products that best fit your business.

Payment options

Essentials

Response Codes

Map the two-digit response codes to safe, generic customer-facing messages, and keep a separate internal reference for support and reconciliation.

Error Handling Examples

Node.js, Python, PHP and Ruby examples for checking a response, mapping response codes to safe messages, and handling retries and field-level errors.

Test card numbers​​​​‌‍​‍​‍‌‍‌​‍‌‍‍‌‌‍‌‌‍‍‌‌‍‍​‍​‍​‍‍​‍​‍‌​‌‍​‌‌‍‍‌‍‍‌‌‌​‌‍‌​‍‍‌‍‍‌‌‍​‍​‍​‍​​‍​‍‌‍‍​‌​‍‌‍‌‌‌‍‌‍​‍​‍​‍‍​‍​‍‌‍‍​‌‌​‌‌​‌​​‌​​‍‍​‍​‍‌‍​‌‌​‍‌‌​‌​‌​​‌‍​‌‌‍‌​‍‍‌​‌‍​‌‌‍‍‌‍‍‌‌‌​‌‍‌​‍‍‌​‌‌​‌‌‌‌‍‌​‌‍‍‌‌‍​‍‌‍‍‌‌‍‍‌‌​‌‍‌‌‌‍‍‌‌​​‍‌‍‌‌‌‍‌​‌‍‍‌‌‌​​‍‌‍‌‌‍‌‍‌​‌‍‌‌​‌‌​​‌​‍‌‍‌‌‌​‌‍‌‌‌‍‍‌‌​‌‍​‌‌‌​‌‍‍‌‌‍‌‍‍​‍‌‍‍‌‌‍‌​​‌​‌​​‍‌​‌‌‍​‍​‍​​‌‌​​​​​​​‍‌‌‍​‌​​​‌‍​‍​​​​‍‌​‌​​‌‍​​‌‍​‌​‍‌​‍‌‌‍​‌​​​‌​‍‌‌‍​‌​​‌‌‍​‍​‍​​‍‌​‌‍‌‍‌‍‌‍​​‍​​‌​​‍​​‌​‍‌‌​‌‍‌‌​​‌‍‌‌​‌‌‍‌​‌‍‌‍​​‍‌​​‌‍​‌‌‌​‌‍‍​​‌‌‍​‍‌‍‌‍‌​‌‍‌​‍‌‌​‌‌‌​​‍‌‌‌‍‍‌‍‌‌‌‍‌​‍‌‌​​‌​‌​​‍‌‌​​‌​‌​​‍‌‌​​‍​​‍‌‍​‌​‌​​​‌‍​​‌​​‌‌​‌​‌‍‌​​‌​​​​‌‍​‍​​​‍‌‌​​‍​​‍​‍‌‌​‌‌‌​‌​​‍‍‌‍‍‌‌‌​‌‍‌‌‌‍‌‌​​‍‌‌​‌‌‌​​‍‌‌‌‍‍‌‍‌‌‌‍‌​‍‌‌​​‌​‌​​‍‌‌​​‌​‌​​‍‌‌​​‍​​‍‌‍‌​​​‍​‌‌‌‍​‌​​​‌‍​‌​‍‌​‌‌‍‌‍​‌​​‌‍​‌​‍‌‌​​‍​​‍​‍‌‌​‌‌‌​‌​​‍‍‌‌​‌‍‍‌‌‌​‌‍​‌‍‌‌​‌‍​‍‌‍​‌‌​‌‍‌‌‌‌‌‌‌​‍‌‍​​‌‌‍‍​‌‌​‌‌​‌​​‌​​‍‌‌​​‌​​‌​‍‌‌​​‍‌​‌‍​‍‌‌​​‍‌​‌‍‌‍​‌‌​‍‌‌​‌​‌​​‌‍​‌‌‍‌​‍‍‌​‌‍​‌‌‍‍‌‍‍‌‌‌​‌‍‌​‍‍‌​‌‌​‌‌‌‌‍‌​‌‍‍‌‌‍​‍‌‍‌‍‍‌‌‍‌​​‌​‌​​‍‌​‌‌‍​‍​‍​​‌‌​​​​​​​‍‌‌‍​‌​​​‌‍​‍​​​​‍‌​‌​​‌‍​​‌‍​‌​‍‌​‍‌‌‍​‌​​​‌​‍‌‌‍​‌​​‌‌‍​‍​‍​​‍‌​‌‍‌‍‌‍‌‍​​‍​​‌​​‍​​‌​‍‌‍‌‌​‌‍‌‌​​‌‍‌‌​‌‌‍‌​‌‍‌‍​​‍‌‍‌​​‌‍​‌‌‌​‌‍‍​​‌‌‍​‍‌‍‌‍‌​‌‍‌​‍‌‌​‌‌‌​​‍‌‌‌‍‍‌‍‌‌‌‍‌​‍‌‌​​‌​‌​​‍‌‌​​‌​‌​​‍‌‌​​‍​​‍‌‍​‌​‌​​​‌‍​​‌​​‌‌​‌​‌‍‌​​‌​​​​‌‍​‍​​​‍‌‌​​‍​​‍​‍‌‌​‌‌‌​‌​​‍‍‌‍‍‌‌‌​‌‍‌‌‌‍‌‌​​‍‌‌​‌‌‌​​‍‌‌‌‍‍‌‍‌‌‌‍‌​‍‌‌​​‌​‌​​‍‌‌​​‌​‌​​‍‌‌​​‍​​‍‌‍‌​​​‍​‌‌‌‍​‌​​​‌‍​‌​‍‌​‌‌‍‌‍​‌​​‌‍​‌​‍‌‌​​‍​​‍​‍‌‌​‌‌‌​‌​​‍‍‌‌​‌‍‍‌‌‌​‌‍​‌‍‌‌​‍‌‍‌​​‌‍‌‌‌​‍‌​‌​​‌‍‌‌‌‍​‌‌​‌‍‍‌‌‌‍‌‍‌‌​‌‌​​‌‌‌‌‍​‍‌‍​‌‍‍‌‌​‌‍‍​‌‍‌‌‌‍‌​​‍​‍‌‌

We provide test card numbers for use in your sandbox environment. Each of the following card numbers has a predetermined purchase response code.​​​​‌‍​‍​‍‌‍‌​‍‌‍‍‌‌‍‌‌‍‍‌‌‍‍​‍​‍​‍‍​‍​‍‌​‌‍​‌‌‍‍‌‍‍‌‌‌​‌‍‌​‍‍‌‍‍‌‌‍​‍​‍​‍​​‍​‍‌‍‍​‌​‍‌‍‌‌‌‍‌‍​‍​‍​‍‍​‍​‍‌‍‍​‌‌​‌‌​‌​​‌​​‍‍​‍​‍‌‍​‌‌​‍‌‌​‌​‌​​‌‍​‌‌‍‌​‍‍‌​‌‍​‌‌‍‍‌‍‍‌‌‌​‌‍‌​‍‍‌​‌‌​‌‌‌‌‍‌​‌‍‍‌‌‍​‍‌‍‍‌‌‍‍‌‌​‌‍‌‌‌‍‍‌‌​​‍‌‍‌‌‌‍‌​‌‍‍‌‌‌​​‍‌‍‌‌‍‌‍‌​‌‍‌‌​‌‌​​‌​‍‌‍‌‌‌​‌‍‌‌‌‍‍‌‌​‌‍​‌‌‌​‌‍‍‌‌‍‌‍‍​‍‌‍‍‌‌‍‌​​‌​‌​​‍‌​‌‌‍​‍​‍​​‌‌​​​​​​​‍‌‌‍​‌​​​‌‍​‍​​​​‍‌​‌​​‌‍​​‌‍​‌​‍‌​‍‌‌‍​‌​​​‌​‍‌‌‍​‌​​‌‌‍​‍​‍​​‍‌​‌‍‌‍‌‍‌‍​​‍​​‌​​‍​​‌​‍‌‌​‌‍‌‌​​‌‍‌‌​‌‌‍‌​‌‍‌‍​​‍‌​​‌‍​‌‌‌​‌‍‍​​‌‌‍​‍‌‍‌‍‌​‌‍‌​‍‌‌​‌‌‌​​‍‌‌‌‍‍‌‍‌‌‌‍‌​‍‌‌​​‌​‌​​‍‌‌​​‌​‌​​‍‌‌​​‍​​‍‌‍​‌​‌​​​‌‍​​‌​​‌‌​‌​‌‍‌​​‌​​​​‌‍​‍​​​‍‌‌​​‍​​‍​‍‌‌​‌‌‌​‌​​‍‍‌‍‍‌‌‌​‌‍‌‌‌‍‌‌​​‍‌‌​‌‌‌​​‍‌‌‌‍‍‌‍‌‌‌‍‌​‍‌‌​​‌​‌​​‍‌‌​​‌​‌​​‍‌‌​​‍​​‍‌‍‌​​​‍​‌‌‌‍​‌​​​‌‍​‌​‍‌​‌‌‍‌‍​‌​​‌‍​‌​‍‌‌​​‍​​‍​‍‌‌​‌‌‌​‌​​‍‍‌‍‌​‌‍‌‌‌​‌‍​‌​‍‌‍‍‌‌​​‌‌​‌‍‍‌‌‍‌‍‍​‌‍​‍‌‍​‌‌​‌‍‌‌‌‌‌‌‌​‍‌‍​​‌‌‍‍​‌‌​‌‌​‌​​‌​​‍‌‌​​‌​​‌​‍‌‌​​‍‌​‌‍​‍‌‌​​‍‌​‌‍‌‍​‌‌​‍‌‌​‌​‌​​‌‍​‌‌‍‌​‍‍‌​‌‍​‌‌‍‍‌‍‍‌‌‌​‌‍‌​‍‍‌​‌‌​‌‌‌‌‍‌​‌‍‍‌‌‍​‍‌‍‌‍‍‌‌‍‌​​‌​‌​​‍‌​‌‌‍​‍​‍​​‌‌​​​​​​​‍‌‌‍​‌​​​‌‍​‍​​​​‍‌​‌​​‌‍​​‌‍​‌​‍‌​‍‌‌‍​‌​​​‌​‍‌‌‍​‌​​‌‌‍​‍​‍​​‍‌​‌‍‌‍‌‍‌‍​​‍​​‌​​‍​​‌​‍‌‍‌‌​‌‍‌‌​​‌‍‌‌​‌‌‍‌​‌‍‌‍​​‍‌‍‌​​‌‍​‌‌‌​‌‍‍​​‌‌‍​‍‌‍‌‍‌​‌‍‌​‍‌‌​‌‌‌​​‍‌‌‌‍‍‌‍‌‌‌‍‌​‍‌‌​​‌​‌​​‍‌‌​​‌​‌​​‍‌‌​​‍​​‍‌‍​‌​‌​​​‌‍​​‌​​‌‌​‌​‌‍‌​​‌​​​​‌‍​‍​​​‍‌‌​​‍​​‍​‍‌‌​‌‌‌​‌​​‍‍‌‍‍‌‌‌​‌‍‌‌‌‍‌‌​​‍‌‌​‌‌‌​​‍‌‌‌‍‍‌‍‌‌‌‍‌​‍‌‌​​‌​‌​​‍‌‌​​‌​‌​​‍‌‌​​‍​​‍‌‍‌​​​‍​‌‌‌‍​‌​​​‌‍​‌​‍‌​‌‌‍‌‍​‌​​‌‍​‌​‍‌‌​​‍​​‍​‍‌‌​‌‌‌​‌​​‍‍‌‍‌​‌‍‌‌‌​‌‍​‌​‍‌‍‍‌‌​​‌‌​‌‍‍‌‌‍‌‍‍​‍‌‍‌​​‌‍‌‌‌​‍‌​‌​​‌‍‌‌‌‍​‌‌​‌‍‍‌‌‌‍‌‍‌‌​‌‌​​‌‌‌‌‍​‍‌‍​‌‍‍‌‌​‌‍‍​‌‍‌‌‌‍‌​​‍​‍‌‌

Merchant guides

Download the guides for all the information you need regarding your merchant account.

Payment terminal guides

Learn more about the payment terminals and how to use them effectively with guides from our payment partner, Fiserv.