Spring til indhold
Forta Pay
English Log ind Book en samtale

Reference

Sandbox

Forta Pay API v1

5 operationer

Kontoens virtuelle ur

GET /sandbox/clock

Svar

200

OK

curl
curl -X GET https://api.fortapay.dk/v1/sandbox/clock \
  -H "Authorization: Bearer $FP_KEY"

Flyt uret frem (dage/timer). Udløser alt planlagt — BS-kørsler, rykkerdage, forfald, partner-kvitteringer — deterministisk

POST /sandbox/clock

Parametre

Idempotency-Key

header · string (uuid) · påkrævet

Obligatorisk på alle POST/PATCH/DELETE. Lever 24 timer.

Krop · object

advance_days

integer · valgfri

advance_hours

integer · valgfri

set_to

string (date-time) · valgfri

Svar

200

Nyt tidspunkt + liste over udløste hændelser

curl
curl -X POST https://api.fortapay.dk/v1/sandbox/clock \
  -H "Authorization: Bearer $FP_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{}
JSON

Simulér en ekstern hændelse — bs_payment_rejected, bs_reversal, card_declined, card_expired, mobilepay_agreement_stopped, fi_payment_received (params amount, payment_id, reference, paid_on, booked_on — samme matchvej som 0602), fi_reversal (0299 på en FI-betaling), collection_partner_ack, collection_partner_dispute, collection_partner_payment, email_bounced (hård afvisning af seneste e-mail → leverancevagten), letter_returned (returpost på seneste brev → leverancevagten), bank_day_closed (target_id = en fremtidig bankdag ÅÅÅÅ-MM-DD lukkes i KONTOENS bankdagskalender; planlagte BS/LS-træk planlægges om, og svaret bærer closed_day og rescheduled[] med charge_id, from og to — samme dag igen er en no-op; /sandbox/reset åbner dagene)

POST /sandbox/simulate

Parametre

Idempotency-Key

header · string (uuid) · påkrævet

Obligatorisk på alle POST/PATCH/DELETE. Lever 24 timer.

Krop · object

kind

string · påkrævet

target_id

string · påkrævet

params

object · valgfri

Svar

200

Udløste hændelser

curl
curl -X POST https://api.fortapay.dk/v1/sandbox/simulate \
  -H "Authorization: Bearer $FP_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{
  "kind": "…",
  "target_id": "…"
}
JSON

Alt der VILLE være sendt (e-mail, SMS, brev, e-Boks, BS-leverancer 0601/0605, partner-pakker) — intet forlader sandboxen. Kreditor-skopet — hver besked bærer `creditor_id`, og en kreditorbegrænset nøgle ser kun sine egne kreditorers

GET /sandbox/outbox

Parametre

cursor

query · string · valgfri

limit

query · integer · valgfri

channel

query · string · valgfri

related_id

query · string · valgfri

Svar

200

OK

curl
curl -X GET https://api.fortapay.dk/v1/sandbox/outbox \
  -H "Authorization: Bearer $FP_KEY"

Nulstil sandbox-kontoen (data + ur)

POST /sandbox/reset

Parametre

Idempotency-Key

header · string (uuid) · påkrævet

Obligatorisk på alle POST/PATCH/DELETE. Lever 24 timer.

Svar

202

Nulstilles

curl
curl -X POST https://api.fortapay.dk/v1/sandbox/reset \
  -H "Authorization: Bearer $FP_KEY" \
  -H "Idempotency-Key: $(uuidgen)"