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. A Hibák és újrapróbálkozások segítségével tesztelje, hogyan kezeli az integrációja a sandbox műveletek által visszaadott érvényesítési, állapot- és újrapróbálható platformhibákat.

Environment variables

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

A sandboxban az ACH, Wire és SWIFT képességeket, a nevesítetteket és az összevontakat is, kizárólag a JPMorgan Chase (jpmorgan) szolgálja ki. Ha ezen képességek valamelyikének kérésekor kihagyja az institutions mezőt, a Swipelux a jpmorgan bankot választja. Bármely más bank megadása 422 capability_institutions_unsupported választ ad. A sandboxban a támogatott képességek listája ezeknél a módszereknél csak a jpmorgan bankot mutatja. Az éles útválasztás és a többi módszer, például az RTP, a Pix és a SPEI, változatlan.

Request a sandbox bank capability

curl --request POST \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}/capabilities/${CAPABILITY_ID}" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Idempotency-Key: sandbox-capability-001" \
  --header "Content-Type: application/json" \
  --data '{"institutions":["jpmorgan"]}'

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:

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

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. Egy 200 válasz is mutathat még nyitott munkát, például ügyfélfeladatokat vagy pending ellenőrzést. A segédeszköz 409 capability_status_blocked választ ad, ha a képesség olyan ok miatt nem érheti el a kért állapotot, amelyet a sandboxban nem tud megszüntetni, például approval_scope_review_required, operatív zárolás vagy végállapot. A probléma statusReason mezője tartalmazza a képesség okkódját és üzenetét, retryable: false értékkel. Az ok resolution mezőjéért olvassa be a képességet. Ha egy nevesített képességet másodszor is rejected állapotra kényszerít, ugyanazt a képességet kapja vissza változatlanul. Ha egy elutasított képességet restricted vagy ready állapotra kényszerít, 422 invalid_capability választ kap. Ezeknek az állapotoknak a teszteléséhez inkább hozzon létre egy új sandbox ügyfelet.

Nyitott feladat tesztelése

Hozzon létre egy sandbox feladatot a POST /v3/sandbox/tasks művelettel. Rendelje ahhoz az erőforráshoz, amelynek a munkafolyamatát teszteli, és az items mezőben írja le, mit kell beküldenie az ügyfélnek. Ez az útmutató capability- és transfer-munkafolyamatokat mutat be; az API Reference tartalmazza a customer scope-ot és a teljes kérési sémát. Szöveges válaszhoz használjon explanation, fájlfeltöltéshez pedig document elemet. Az új profile elemekhez profilePointer is szükséges, amely az ügyfélmezőt megnevező JSON Pointer. A többi elemtípusért és mezőért lásd a Sandbox feladat létrehozása oldalt. A transfer-példához először hozzon létre sandbox transfert pay-in vagy payout munkafolyamattal, majd exportálja a visszaadott data.id értéket:

Transfer ID

export TRANSFER_ID='tr_replace_with_your_transfer_id'

Képesség + magyarázat
Átutalási RFI + dokumentum

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

Szűkítse a feladat scope-ját a felülvizsgálat alatt álló átutalásra, és kérjen egy dokumentumot olyan constraints beállításokkal, amelyek szűkítik az elfogadott típusokat, formátumokat és kort.

Create document task

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": "transfer",
    "customerId": "${CUSTOMER_ID}",
    "transferId": "${TRANSFER_ID}"
  },
  "category": "transaction_rfi",
  "items": [
    {
      "type": "document",
      "request": "Upload a bank statement showing the source of funds for this transfer.",
      "constraints": {
        "acceptedDocumentTypes": ["bank_statement"],
        "acceptedFormats": ["pdf", "jpeg"],
        "maxAgeDays": 90
      }
    }
  ]
}
JSON

A példa korlátozza az elfogadott dokumentumtípust, formátumot és kort. Az összes támogatott dokumentumkorlátozásért lásd a Sandbox feladat létrehozása oldalt.

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. A POST /v3/customers/{customerId}/tasks/{taskId}/submissions hívásakor a válasz típusa egyezzen a létrehozott elemmel:

Magyarázati válasz
Dokumentumválasz

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

Töltsön fel egy megfelelő fájlt a POST /v3/customers/{customerId}/documents művelettel, tárolja a visszaadott data.id értéket DOCUMENT_ID-ként, majd küldje be dokumentumválaszként:

Upload document

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-document-submission-001" \
  --header "Content-Type: application/json" \
  --data @- <<JSON
{
  "taskRevision": ${TASK_REVISION},
  "answers": [
    {
      "requirementId": "${REQUIREMENT_ID}",
      "answer": {
        "type": "document",
        "documentIds": ["${DOCUMENT_ID}"]
      }
    }
  ]
}
JSON

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

Review submission

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

Ellenőrizheti a POST /v3/sandbox/tasks által létrehozott feladatokat és a Swipelux által gyűjtött képesség-felvételi feladatokat. Az Operations vagy egy másik munkafolyamat tulajdonában lévő feladat ellenőrzése 409 task_not_sandbox_reviewable választ ad. Ez a feladat továbbra is olvasható a feladat-végpontokon keresztül, és a tulajdonosa általi ellenőrzésre vár. A 404 task_not_found azt jelenti, hogy a feladatazonosító ismeretlen, vagy egy másik kereskedőhöz tartozik. 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:

Top up issued wallet

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. A feltöltés azonosítója egyben átutalás-azonosító is. Kérje le a GET /v3/transfers/{transferId} művelettel, vagy listázza a GET /v3/transfers művelettel, hogy a bejövő befizetési kódútvonalát sandbox feltöltésekkel gyakorolja. Az átutalás vetülete egy befejezett bejövő stablecoin befizetés origin: "inbound_deposit", method: "stablecoin_transfers" és direction: "stablecoin_move" értékekkel, és az egyező accountId, origin, method és direction listaszűrők adják vissza.

Á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