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

Number Brand CVV Expiration Date
5031433215406351 Mastercard 123 11/2030
4235647728025682 Visa 123 11/2030
375365153556885 American Express 1234 11/2030

<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.

Number Description
6011457819940087 The transaction will be declined with a code "card_declined"
4929710426637678 The transaction will be declined with a code "card_declined"
4710426743216178 The transaction will be declined with a code "service_request_timeout"
Payment status Description Identification document
APRO Payment approved (CPF) 12345678909
OTHE Declined due to general error (CPF) 12345678909
CONT Pending payment -
CALL Declined with validation to authorize -
FUND Declined due to insufficient funds -
SECU Declined due to invalid security code -
EXPI Declined due to expiration date issue -
FORM Declined due to form error -
CARD Rejected due to missing card_number -
INST Rejected due to invalid installments -
DUPL Rejected due to duplicate payment -
LOCK Rejected due to disabled card -
CTNA Rejected due to card type not allowed -
ATTE Rejected due to exceeded card pin attempts -
BLAC Rejected due to blacklisted -
UNSU Not supported -
TEST Used to apply value rules -

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>