Sandbox tesztelés

A sandbox ugyanazt az API-hosztot használja, mint az éles környezet. A sandbox API-kulcs kiválasztja a tesztkörnyezetet, ahol a segédeszközök valós pénzmozgás nélkül szimulálják a kimeneteket. Tartsa a kulcsot a backendjén. A sandbox segédeszközök nem helyettesítik az éles megfelelőséget vagy onboardingot.

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

Képesség készenlétének tesztelése

Egy képesség kérése után állítsa be annak sandbox státuszát a POST /v3/sandbox/customers/{customerId}/capabilities/{capabilityId}/status művelettel:

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"}'

A segédeszköz használata után frissítse le a képességet. Az aktuális status és openTaskIds értékeit tekintse annak az eredménynek, amelyet a terméknek kezelnie kell.

Nyitott feladat tesztelése

Hozzon létre egy képességhez kötött feladatot a POST /v3/sandbox/tasks művelettel:

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

Tárolja a data.id értéket TASK_ID-ként, a data.revision értéket TASK_REVISION-ként, az aktuális data.requirements[0].id értéket pedig REQUIREMENT_ID-ként. Küldje el a választ a POST /v3/customers/{customerId}/tasks/{taskId}/submissions művelettel:

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

Ezután fogadja el vagy utasítsa el az aktuális beküldést a POST /v3/sandbox/tasks/{taskId}/review művelettel:

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"}'

Használja a Képességek és feladatok útmutatót az éles feladat-elvégzési mintához.

Sandbox tárca feltöltése

Írjon jóvá egy kibocsátott tárcát a POST /v3/sandbox/accounts/{accountId}/topup művelettel:

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"}'

Tárolja a visszakapott data.id értéket TRANSFER_ID-ként, ha meg szeretné vizsgálni a szimulált feltöltési átutalást.

Átutalás befejezése vagy sikertelenné tétele

Állítsa be a kimenetet a POST /v3/sandbox/transfers/{transferId}/state művelettel:

Befejezés
Sikertelen

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

Ezután futtasson pénzbefizetési, kifizetési vagy kibocsátott bankszámla folyamatot sandboxban.

Kezdő lépések

Ügyfelek beléptetése

Pénzáramlások kiépítése

Élesítés

Sandbox tesztelés

Képesség készenlétének tesztelése

Nyitott feladat tesztelése

Sandbox tárca feltöltése

Átutalás befejezése vagy sikertelenné tétele

​Képesség készenlétének tesztelése

​Nyitott feladat tesztelése

​Sandbox tárca feltöltése

​Átutalás befejezése vagy sikertelenné tétele

Képesség készenlétének tesztelése

Nyitott feladat tesztelése

Sandbox tárca feltöltése

Átutalás befejezése vagy sikertelenné tétele