Proves de sandbox

El sandbox utilitza el mateix host d’API que la producció. Una clau d’API de sandbox selecciona l’entorn de proves, on els helpers simulen resultats sense moure fons reals. Manté la clau al teu backend. Els helpers de sandbox no substitueixen el compliment ni la incorporació de producció.

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

Prova la preparació d’una capacitat

Després de sol·licitar una capacitat, estableix el seu estat al sandbox amb 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"}'

Torna a obtenir la capacitat després d’utilitzar el helper. Tracta el seu status i openTaskIds actuals com el resultat que el teu producte ha de gestionar.

Prova una tasca oberta

Crea una tasca amb àmbit de capacitat amb 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

Emmagatzema data.id com a TASK_ID, data.revision com a TASK_REVISION i l’actual data.requirements[0].id com a REQUIREMENT_ID. Envia la resposta mitjançant 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

A continuació, accepta o rebutja l’enviament actual amb 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"}'

Utilitza Capacitats i tasques per al patró de compleció de tasques en producció.

Finança una cartera de sandbox

Acredita una cartera emesa amb 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"}'

Emmagatzema el data.id retornat com a TRANSFER_ID quan vulguis inspeccionar la transferència de finançament simulada.

Completa o falla una transferència

Estableix el resultat amb POST /v3/sandbox/transfers/{transferId}/state:

Completar
Fallar

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

A continuació, executa un flux de cobrament, pagament o compte bancari emès al sandbox.

Comença aquí

Incorpora clients

Construeix fluxos de diners

Llança

Proves de sandbox

Prova la preparació d’una capacitat

Prova una tasca oberta

Finança una cartera de sandbox

Completa o falla una transferència

​Prova la preparació d’una capacitat

​Prova una tasca oberta

​Finança una cartera de sandbox

​Completa o falla una transferència

Prova la preparació d’una capacitat

Prova una tasca oberta

Finança una cartera de sandbox

Completa o falla una transferència