Introduction

Authentication

Test cards

Establishments

Users

Customers

Cards

Payment links

Error codes

Payment Split

Products

Discount Coupons

Sales

Signatures

Webhooks

Financial

On this page:

Reduce the chances of errors. Learn more about different testing methods for simulating and validating your card payment integration before the launch.

<aside> 💡 To use the test cards, you must contact our team to enable transactions in the staging environment.

</aside>

What are test cards?

Test cards are fictional credit cards. These cards are primarily used by development professionals to simulate, validate, and confirm the proper functioning of checkout processes and other types of online payment environments.

This page includes test card numbers and other information to ensure that your integration works correctly. We recommend creating different scenarios during your testing phase to guarantee good results in various situations.

<aside> ⚠️ Please do not use test card numbers in a production environment. These cards are valid only in the test environment.

</aside>

List of National Cards

<aside> 💡 Following the rules above, you can use any Cardholder Name in the field holder_name, a valid month in the field expiration_month, a valid year and in the future in the field expiration_year and finally, a valid value in the security_code to test your transactions.

</aside>

List of Declined National Cards

You should test card numbers that will automatically encounter some error. This way, it becomes easier to verify different possibilities, reducing the likelihood of errors after the launch.

List of Declined International Cards

You should test card numbers that will automatically encounter some error. This way, it becomes easier to verify different possibilities, reducing the probability of errors after the launch.

<aside> 💡 Any address and CVC (Card Verification Code) entered will be accepted. Any future expiration date will also be accepted. You may also want to simulate more specific error scenarios as the ones below: invalid_expiry_month: Use an invalid month. For example: 13. invalid_expiry_year: Use an expiration date in the past. For example: 1970. invalid_cvc: Use only two verification digits for the card. For example: 99.

</aside>

Related Content

<aside> <img src="/icons/credit-card_red.svg" alt="/icons/credit-card_red.svg" width="40px" />

Payment Methods - Credit Card

</aside>

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/97c1b0fd-997a-49bc-b769-152f2220a2d9/POST.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/97c1b0fd-997a-49bc-b769-152f2220a2d9/POST.png" width="40px" /> POST - Add card

</aside>