沙箱测试
Liquido 提供沙箱测试环境，你可以通过配置不同的返回参数来模拟不同的响应场景，以便进行系统集成和测试工作。
测试指南¶
一般情况下，测试支付（除信用卡外）会以异步方式处理，即在提交请求后，你将首先收到一个 IN_PROGRESS 状态。 在预设的延迟时间结束后（默认3分钟），支付将自动结算，并发送商户通知。
自定义测试参数¶
你可以在请求的 description 字段中设置测试参数，以定制测试行为。参数格式如下：
- 每个参数使用等号连接键值
- 多个参数用分号分隔
示例：Param1=Value1;Param2=Value2;Param3=Value3......
请求体
{
"idempotencyKey": "hz-testpixdynamic-230703-001",
"amount": 100,
"currency": "BRL",
"country": "BR",
"paymentMethod": "PIX_DYNAMIC_QR",
"paymentFlow": "DIRECT",
... # 其他字段
"description": "finalStatus=SETTLED;asyncFinalizationDelay=10;"
}
可用测试参数：
| 参数名 | 可选值（绿色为默认值） | 描述 |
|---|---|---|
| finalStatus | SETTLED/FAILED - 支付、退款的值CANCELLED/FAILED - 取消的值 |
自定义支付的最终状态，用于测试失败或取消的情况。信用卡支付中不生效 |
| asyncFinalizationDelay | 数值（秒） | 模拟自动结算需要等待的延迟时间。默认值为 3 分钟。 |
信用卡测试¶
使用不同的测试卡号可以模拟不同的测试场景。以下为支持的测试卡信息：
| 卡号 | 品牌 | 描述 |
|---|---|---|
| 4242424242424242 | Visa | Visa 信用卡，返回成功响应 |
| 4000000000007726 | Visa | Visa 信用卡，返回成功响应，退款为异步流程 |
| 4000001240000000 | Visa | Visa 信用卡，支付被拒绝 |
| 4000000000000069 | Visa | Visa 信用卡，卡已过期 |
| 4444444444444448 | Visa | Visa 信用卡，余额不足 |
| 4000000000000044 | Visa | Visa 信用卡，欺诈错误 |
| 4111111111111111 | Visa | Visa 借记卡，成功响应 巴西地区需 3DS 验证 |
| 4000000000001034 | Visa | Visa 信用卡，3DS 无挑战下成功 |
| 4000000000001026 | Visa | Visa 信用卡，3DS 无挑战下被拒绝 |
| 4000000000012700 | Visa | Visa 信用卡，经挑战后 3DS 验证成功 |
| 4000000000004400 | Visa | Visa 信用卡，经挑战后 3DS 验证被拒绝 |
| 4000002230000018 | Visa | Visa 信用卡，3DS 拒绝 |
| 5105105105105100 | Mastercard | Mastercard 信用卡，成功响应 |
| 5150000000000833 | Mastercard | Mastercard 信用卡，成功响应，退款为异步流程 |
| 5150000000005683 | Mastercard | Mastercard 信用卡，支付被拒绝 |
| 5150000000004611 | Mastercard | Mastercard 信用卡，卡已过期 |
| 5150000000003118 | Mastercard | Mastercard 信用卡，余额不足 |
| 5454545454545454 | Mastercard | Mastercard 信用卡，欺诈错误 |
| 5555555555554444 | Mastercard | Mastercard 借记卡，成功响应 巴西地区需 3DS 验证 |
| 341111111111111 | AmericanExpress | American Express 信用卡，成功响应 |
| 378200000004077 | AmericanExpress | American Express 信用卡，成功响应，退款为异步流程 |
| 378200000006510 | AmericanExpress | American Express 信用卡，支付被拒绝 |
| 378200000004200 | AmericanExpress | American Express 信用卡，卡已过期 |
| 378200000007724 | AmericanExpress | American Express 信用卡，余额不足 |
| 378200000004184 | AmericanExpress | American Express 信用卡，欺诈错误 |
| 340082000001260 | AmericanExpress | American Express 借记卡，成功响应 巴西地区需 3DS 验证 |
| 2869000000003133 | Carnet | Carnet 信用卡，成功响应 |
| 2869000000000428 | Carnet | Carnet 信用卡，成功响应，退款为异步流程 |
| 2869000000000303 | Carnet | Carnet 信用卡，支付被拒绝 |
| 2869000000000246 | Carnet | Carnet 信用卡，卡已过期 |
| 2869000000000006 | Carnet | Carnet 信用卡，余额不足 |
| 2869000000000030 | Carnet | Carnet 信用卡，欺诈错误 |
| 5022750000006364 | Carnet | Carnet 借记卡，成功响应 |
| 6011410000008404 | Discover | Discover 信用卡，成功响应 |
| 6011410000000526 | Discover | Discover 信用卡，成功响应，退款为异步流程 |
| 6011410000000856 | Discover | Discover 信用卡，支付被拒绝 |
| 6011410000000682 | Discover | Discover 信用卡，卡已过期 |
| 6011410000000237 | Discover | Discover 信用卡，余额不足 |
| 6011410000005152 | Discover | Discover 信用卡，欺诈错误 |
| 6500000000000226 | Discover | Discover 借记卡，成功响应 巴西地区需 3DS 验证 |
| 5067080000000001 | Elo | Elo 信用卡，成功响应 |
| 5067080000000076 | Elo | Elo 信用卡，成功响应，退款为异步流程 |
| 5067080000000027 | Elo | Elo 信用卡，支付被拒绝 |
| 5067080000000050 | Elo | Elo 信用卡，卡已过期 |
| 5067080000000084 | Elo | Elo 信用卡，余额不足 |
| 5067080000000043 | Elo | Elo 信用卡，欺诈错误 |
| 4514160000007008 | Elo | Elo 借记卡，成功响应 巴西地区需 3DS 验证 |
| 3841000000005105 | Hipercard | Hipercard 信用卡，成功响应 |
| 3841000000000601 | Hipercard | Hipercard 信用卡，成功响应，退款为异步流程 |
| 3841000000000304 | Hipercard | Hipercard 信用卡，支付被拒绝 |
| 3841000000000700 | Hipercard | Hipercard 信用卡，卡已过期 |
| 3841000000000007 | Hipercard | Hipercard 信用卡，余额不足 |
| 3841000000001674 | Hipercard | Hipercard 信用卡，欺诈错误 |
| 6062820000004575 | Hipercard | Hipercard 借记卡，成功响应 巴西地区需 3DS 验证 |
| 7242424242424245 | Unknown brand | 未知品牌信用卡，成功响应 |