沙盒测试

沙盒与生产环境使用同一个 API 主机。沙盒 API 密钥会选择测试环境,其中的辅助接口可在不真正划转资金的情况下模拟各种结果。请将该密钥保存在您的后端。沙盒辅助接口并不能替代生产环境的合规或入驻流程。

export API_BASE='https://platform.swipelux.com'
export SWIPELUX_SANDBOX_API_KEY='replace-with-your-sandbox-key'

测试能力的就绪状态

申请某个能力后,使用 POST /v3/sandbox/customers/{customerId}/capabilities/{capabilityId}/status 设置其沙盒状态:

curl --request POST \
  "${API_BASE}/v3/sandbox/customers/${CUSTOMER_ID}/capabilities/${CAPABILITY_ID}/status" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Content-Type: application/json" \
  --data '{"status":"ready"}'

使用辅助接口后,请重新拉取该能力。将其当前的 status 与 openTaskIds 视为您的产品必须处理的结果。

测试一个待办任务

使用 POST /v3/sandbox/tasks 创建一个能力范围内的任务:

curl --request POST \
  "${API_BASE}/v3/sandbox/tasks" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Content-Type: application/json" \
  --data @- <<JSON
{
  "scope": {
    "type": "capability",
    "customerId": "${CUSTOMER_ID}",
    "capabilityId": "${CAPABILITY_ID}"
  },
  "items": [
    {
      "type": "explanation",
      "request": "Explain the source of funds."
    }
  ]
}
JSON

将 data.id 保存为 TASK_ID,data.revision 保存为 TASK_REVISION,并将当前的 data.requirements[0].id 保存为 REQUIREMENT_ID。使用 POST /v3/customers/{customerId}/tasks/{taskId}/submissions 提交答案:

curl --request POST \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}/tasks/${TASK_ID}/submissions" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Idempotency-Key: sandbox-task-submission-001" \
  --header "Content-Type: application/json" \
  --data @- <<JSON
{
  "taskRevision": ${TASK_REVISION},
  "answers": [
    {
      "requirementId": "${REQUIREMENT_ID}",
      "answer": {
        "type": "text",
        "value": "Sandbox requirement completed."
      }
    }
  ]
}
JSON

然后使用 POST /v3/sandbox/tasks/{taskId}/review 接受或拒绝当前的提交:

curl --request POST \
  "${API_BASE}/v3/sandbox/tasks/${TASK_ID}/review" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Content-Type: application/json" \
  --data '{"outcome":"accepted"}'

生产环境的任务完成模式请参阅能力与任务。

为沙盒钱包充值

使用 POST /v3/sandbox/accounts/{accountId}/topup 向一个发行的钱包入账:

curl --request POST \
  "${API_BASE}/v3/sandbox/accounts/${ACCOUNT_ID}/topup" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Content-Type: application/json" \
  --data '{"amount":"250.00","currency":"USDC"}'

如需查看这次模拟的入金转账,请将返回的 data.id 保存为 TRANSFER_ID。

完成或失败一笔转账

使用 POST /v3/sandbox/transfers/{transferId}/state 设置其结果:

完成
失败

curl --request POST \
  "${API_BASE}/v3/sandbox/transfers/${TRANSFER_ID}/state" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Content-Type: application/json" \
  --data '{"state":"completed"}'

curl --request POST \
  "${API_BASE}/v3/sandbox/transfers/${TRANSFER_ID}/state" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "state": "failed",
  "stateDetail": {
    "code": "sandbox_review",
    "message": "Sandbox transfer failed."
  }
}
JSON

接下来,在沙盒中运行入金、出金或发行银行账户流程。

开始使用

客户入驻

构建资金流

上线

测试能力的就绪状态

测试一个待办任务

为沙盒钱包充值

完成或失败一笔转账

​测试能力的就绪状态

​测试一个待办任务

​为沙盒钱包充值

​完成或失败一笔转账

测试能力的就绪状态

测试一个待办任务

为沙盒钱包充值

完成或失败一笔转账