Skip to content

Sandbox Testing

Liquido provides sandbox testing where you can configure returned parameters to simulate different responses for integration and testing purposes.

Test Guide

Generally, test payments will be processed asynchronously except credit card. That is, you will receive IN_PROGRESS after submitting the request. After a predefined delay (3 minutes by default), the payment will be settled automatically, and merchant notification will be sent.

Custom Test Parameters

You can specify test parameters in request's description field to customize the test.

  • The parameter name and value should be separated by an equal sign.
  • Parameters should be separated by a semicolon.

Example: Param1=Value1;Param2=Value2;Param3=Value3......

Request Body
{
    "idempotencyKey": "hz-testpixdynamic-230703-001",
    "amount": 100,
    "currency": "BRL",
    "country": "BR",
    "paymentMethod": "PIX_DYNAMIC_QR",
    "paymentFlow": "DIRECT",
    ...  # other fields
    "description": "finalStatus=SETTLED;asyncFinalizationDelay=10;"
}

Available test parameters:

Name Possible Values (green is the default value) Description
finalStatus SETTLED/FAILED - when payment and refund
CANCELLED/FAILED - when cancellation		 Customize the final status of a payment. Useful for testing failure cases.
Will be ignored in card payments
asyncFinalizationDelay A numeric value (in seconds) Delay before the auto finalization should be triggered. Default Delay is 3 minutes.

Card

Using different test card numbers for different test purposes. Available card numbers:

Card Number Card Brand Description
4242424242424242 Visa Visa credit card for successful response.
4000000000007726 Visa Visa credit card for successful response. Refunds will use asynchronous refund flow.
4000001240000000 Visa Visa credit card for payment rejected response.
4000000000000069 Visa Visa credit card for card expired error.
4444444444444448 Visa Visa credit card for insufficient funds error.
4000000000000044 Visa Visa credit card for fraud error.
4111111111111111 Visa Visa debit card for successful response.
3DS is required in Brazil
4000000000001034 Visa Visa credit card success after frictionless 3ds.
4000000000001026 Visa Visa credit card rejected after frictionless 3ds.
4000000000012700 Visa Visa credit card success after challenge 3ds.
4000000000004400 Visa Visa credit card rejected after challenge 3ds.
4000002230000018 Visa Visa credit card rejected by 3ds.
5105105105105100 Mastercard Mastercard credit card for successful response.
5150000000000833 Mastercard Mastercard credit card for successful response. Refunds will use asynchronous refund flow.
5150000000005683 Mastercard Mastercard credit card for payment rejected response.
5150000000004611 Mastercard Mastercard credit card for card expired error.
5150000000003118 Mastercard Mastercard credit card for insufficient funds error.
5454545454545454 Mastercard Mastercard credit card for fraud error.
5555555555554444 Mastercard Mastercard debit card for successful response.
3DS is required in Brazil
341111111111111 AmericanExpress American express credit card for successful response.
378200000004077 AmericanExpress American express credit card for successful response. Refunds will use asynchronous refund flow.
378200000006510 AmericanExpress American express credit card for payment rejected response.
378200000004200 AmericanExpress American express credit card for card expired error.
378200000007724 AmericanExpress American express credit card for insufficient funds error.
378200000004184 AmericanExpress American express credit card for fraud error.
340082000001260 AmericanExpress American express debit card for successful response.
3DS is required in Brazil
2869000000003133 Carnet Carnet credit card for successful response.
2869000000000428 Carnet Carnet credit card for successful response. Refunds will use asynchronous refund flow.
2869000000000303 Carnet Carnet credit card for payment rejected response.
2869000000000246 Carnet Carnet credit card for card expired error.
2869000000000006 Carnet Carnet credit card for insufficient funds error.
2869000000000030 Carnet Carnet credit card for fraud error.
5022750000006364 Carnet Carnet debit card for successful response.
6011410000008404 Discover Discover credit card for successful response.
6011410000000526 Discover Discover credit card for successful response. Refunds will use asynchronous refund flow.
6011410000000856 Discover Discover credit card for payment rejected response.
6011410000000682 Discover Discover credit card for card expired error.
6011410000000237 Discover Discover credit card for insufficient funds error.
6011410000005152 Discover Discover credit card for fraud error.
6500000000000226 Discover Discover debit card for successful response.
3DS is required in Brazil
5067080000000001 Elo Elo credit card for successful response.
5067080000000076 Elo Elo credit card for successful response. Refunds will use asynchronous refund flow.
5067080000000027 Elo Elo credit card for payment rejected response.
5067080000000050 Elo Elo credit card for card expired error.
5067080000000084 Elo Elo credit card for insufficient funds error.
5067080000000043 Elo Elo credit card for fraud error.
4514160000007008 Elo Elo debit card for successful response.
3DS is required in Brazil
3841000000005105 Hipercard Hipercard credit card for successful response.
3841000000000601 Hipercard Hipercard credit card for successful response. Refunds will use asynchronous refund flow.
3841000000000304 Hipercard Hipercard credit card for payment rejected response.
3841000000000700 Hipercard Hipercard credit card for card expired error.
3841000000000007 Hipercard Hipercard credit card for insufficient funds error.
3841000000001674 Hipercard Hipercard credit card for fraud error.
6062820000004575 Hipercard Hipercard debit card for successful response.
3DS is required in Brazil
7242424242424245 Unknown brand Unknown brand credit card for successful response.
Back to top