沙箱测试
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 ) |