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. That is, merchants will receive IN_PROGRESS after submitting the request. After several seconds (15 seconds 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 comment 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": "idempotency-key",
    "country": "BR",
    "targetName": "test user a",
    "targetEmail": "testa@liquido.com",
    "targetDocument": "24912345678",
    "targetPixKey": "testa@liquido.com",
    "targetPixKeyType": "email",
    "amountInCents": 100,
    "currency": "BRL",
    "callbackUrl": "https://api.client.com/callback/",
    "subMerchantId": "UUID",
    "comment": "statusEvent=SETTLED;statusDelay=20;"
}

Available test parameters:

Name Possible Values Description
statusEvent SETTLED - payout tranfer status will be from IN_PROGRESS to SETTLED
REJECTED - payout tranfer status will be from IN_PROGRESS to REJECTED
SETTLED_THEN_REJECTED - payout transfer status will be from IN_PROGRESS to SETTLED . Finally, it will be REJECTED		 Customize the status change of a payment. Useful for testing failure cases.
(SETTLED_THEN_REJECTED Usually occurs when the recipient returns the money)
statusDelay A numeric value (in seconds) Time intervals between different status changes.
Default value is 15 seconds (The input parameter must be greater than 15, otherwise the transaction will REJECTED)
Back to top