Testování v sandboxu

Sandbox používá stejný API host jako produkce. Sandbox API klíč vybírá testovací prostředí, kde pomocníci simulují výsledky bez přesunu skutečných prostředků. Uchovávejte klíč na svém backendu. Sandbox pomocníci nenahrazují produkční compliance ani onboarding. Použijte Chyby a opakování k otestování toho, jak vaše integrace zpracovává validační a stavové chyby i opakovatelná selhání platformy vracená sandboxovými operacemi.

Environment variables

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

Test připravenosti capability

V sandboxu jsou capabilities ACH, Wire a SWIFT, pojmenované i sdružené, obsluhovány pouze v JPMorgan Chase (jpmorgan). Pokud při žádosti o některou z těchto capabilities vynecháte institutions, Swipelux zvolí jpmorgan. Uvedení jakékoli jiné banky vrátí 422 capability_institutions_unsupported. Seznam podporovaných capabilities v sandboxu u těchto metod zobrazuje pouze jpmorgan. Produkční směrování a další metody, jako RTP, Pix a SPEI, se nemění.

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

Po požadavku na capability nastavte její sandbox stav pomocí POST /v3/sandbox/customers/{customerId}/capabilities/{capabilityId}/status:

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

Po použití pomocníka znovu načtěte capability. Zacházejte s jejím aktuálním status a openTaskIds jako s výsledkem, který musí váš produkt zpracovat. Odpověď 200 může stále zobrazovat otevřenou práci, například úkoly zákazníka nebo kontrolu ve stavu pending. Pomocník vrátí 409 capability_status_blocked, když capability nemůže dosáhnout požadovaného stavu z důvodu, který v sandboxu nemůžete odstranit, například approval_scope_review_required, provozní blokace nebo konečný stav. Pole statusReason v problému obsahuje kód a zprávu důvodu capability s retryable: false. Pro resolution důvodu si načtěte capability. Opakované vynucení pojmenované capability do stavu rejected vrátí stejnou capability beze změny. Vynucení zamítnuté capability do stavu restricted nebo ready vrátí 422 invalid_capability. K otestování těchto stavů místo toho vytvořte nového sandboxového zákazníka.

Test otevřeného úkolu

Vytvořte sandboxový úkol pomocí POST /v3/sandbox/tasks. Navažte jej na prostředek, jehož pracovní postup testujete, a pomocí items popište, co má zákazník odeslat. Tato příručka ukazuje workflow pro capability a transfer; API Reference definuje customer scope a úplné schéma požadavku. Pro textovou odpověď použijte položku explanation a pro nahrání souboru položku document. Nové položky profile také vyžadují profilePointer, JSON Pointer určující pole zákazníka. Další typy položek a pole najdete v Create sandbox task. Pro příklad transferu nejprve vytvořte sandboxový transfer pomocí workflow pay-in nebo payout a potom exportujte vrácené data.id:

Transfer ID

export TRANSFER_ID='tr_replace_with_your_transfer_id'

Capability + vysvětlení
RFI k převodu + dokument

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

Omezte úkol na kontrolovaný převod a vyžádejte dokument s constraints, které zúží přijímané typy, formáty a stáří.

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

Příklad omezuje přijímaný typ, formát a stáří dokumentu. Všechny podporované podmínky dokumentu najdete v Create sandbox task.

Uložte data.id jako TASK_ID, data.revision jako TASK_REVISION a aktuální data.requirements[0].id jako REQUIREMENT_ID. Při volání POST /v3/customers/{customerId}/tasks/{taskId}/submissions musí odpověď odpovídat vytvořené položce:

Odpověď s vysvětlením
Odpověď s dokumentem

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

Nahrajte odpovídající soubor pomocí POST /v3/customers/{customerId}/documents, uložte vrácené data.id jako DOCUMENT_ID a odešlete jej jako odpověď s dokumentem:

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

Poté aktuální odeslání přijměte nebo zamítněte pomocí POST /v3/sandbox/tasks/{taskId}/review:

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

Můžete kontrolovat úkoly vytvořené pomocí POST /v3/sandbox/tasks a úkoly příjmu capabilities, které Swipelux shromažďuje. Kontrola úkolu, který vlastní Operations nebo jiný workflow, vrátí 409 task_not_sandbox_reviewable. Takový úkol zůstává čitelný přes endpointy úkolů a čeká, až jej zkontroluje jeho vlastník. 404 task_not_found znamená, že ID úkolu je neznámé nebo patří jinému obchodníkovi. Pro produkční vzor dokončování úkolů použijte Capabilities a úkoly.

Naplnění sandboxové peněženky

Připište prostředky vydané peněžence pomocí POST /v3/sandbox/accounts/{accountId}/topup:

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

Uložte vrácené data.id jako TRANSFER_ID, když chcete zkontrolovat simulovaný financovací převod. ID topupu je ID převodu. Načtěte jej přes GET /v3/transfers/{transferId} nebo vypište přes GET /v3/transfers, abyste otestovali svůj kód pro příchozí vklady proti sandboxovým topupům. Projekce převodu je dokončený příchozí stablecoinový vklad s origin: "inbound_deposit", method: "stablecoin_transfers" a direction: "stablecoin_move" a je vracen odpovídajícími filtry seznamu accountId, origin, method a direction.

Dokončení nebo selhání převodu

Nastavte výsledek pomocí POST /v3/sandbox/transfers/{transferId}/state:

Dokončit
Selhat

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

Dále spusťte tok příchozí platby, výplaty nebo vydaného bankovního účtu v sandboxu.

Začínáme

Onboarding zákazníků

Vytvořte peněžní toky

Spuštění

Testování v sandboxu

Test připravenosti capability

Test otevřeného úkolu

Naplnění sandboxové peněženky

Dokončení nebo selhání převodu

​Test připravenosti capability

​Test otevřeného úkolu

​Naplnění sandboxové peněženky

​Dokončení nebo selhání převodu

Test připravenosti capability

Test otevřeného úkolu

Naplnění sandboxové peněženky

Dokončení nebo selhání převodu