跳转至

沙箱测试

Liquido 提供沙箱测试环境,你可以通过配置不同的返回参数来模拟不同的响应场景,以便进行系统集成和测试工作。

测试指南

一般情况下,测试支付会以异步方式处理,即在提交请求后,你将首先收到一个 IN_PROGRESS 状态。 在预设的延迟时间结束后(默认15秒),支付将自动结算,并发送商户通知。

自定义测试参数

你可以在请求的 comment 字段中设置测试参数,以定制测试行为。参数格式如下:

  • 每个参数使用等号连接键值
  • 多个参数用分号分隔

示例:Param1=Value1;Param2=Value2;Param3=Value3......

请求体
{
    "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;"
}

可用测试参数:

参数名 可选值 描述
statusEvent SETTLED - 付款状态将从 IN_PROGRESS 变为 SETTLED
REJECTED - 付款状态将从 IN_PROGRESS 变为 REJECTED
SETTLED_THEN_REJECTED - 付款状态将先从 IN_PROGRESS 变为 SETTLED,最终变为 REJECTED
用于自定义付款状态。在测试失败的情况下很有用。
SETTLED_THEN_REJECTED 通常出现在收款人退回款项的情况下)
statusDelay 数值(秒) 模拟状态间变更的延迟时间。
默认值为15秒(此参数值必须大于15,否则交易会REJECTED
回到页面顶部