Test din betaling

Med en rk_test_-nøgle rammer betalinger husets sandbox, ikke en bank. Du kan spille kort-trinnet i en checkout-session uden browser og uden kort — og få gateway-callbacket leveret til Rieck ad den ÆGTE vej (signeret, verificeret, bogført), så dit eget webhook-endepunkt ser hændelsen:

curl -X POST https://api.rieckflow.com/v1/test/gateway-callbacks \
  -H "Authorization: Bearer $RIECK_TEST_API_KEY" \
  -H "Idempotency-Key: play-declined-1" \
  -H "Content-Type: application/json" \
  -d '{ "reference": "FAK-…", "outcome": "declined" }'

reference er den, POST /v1/checkout-sessions gav dig. outcome vælger, hvad «kortet» svarer:

`outcome`	Hvad der sker	Din webhook får	QuickPay-kode
`approved` (default)	Betalingen bogføres på fakturaen	`payment.received`	—
`declined`	Afvist af indløseren; forsøget står i sporet	`payment.failed`	40000
`card_expired`	Kortet er udløbet; forsøget står i sporet	`payment.failed`	40002
`requires_3ds`	⚠️ Betalingen VENTER på en 3DS-udfordring — det er ikke et nej	intet endnu	30100

Svaret bærer callback.result (hvad Riecks webhook-handler gjorde med leveringen) og expectedEvent. amountOere er valgfrit og må ikke overstige fakturaens restbeløb.

⚠️ Udfaldet ligger på kaldet, ikke på kortnummeret og ikke på beløbet. QuickPays eget testmiljø styrer udfaldet med testkort (1000 0000 0000 0016 = afvist); husets sandbox ser aldrig kortnummeret, fordi kortdata sendes uden om os. Og beløbet er forretningsdata: en simulator, hvor «…123» betyder afvist, gør et vilkårligt inkassobeløb til en tilfældig fejl.

⚠️ Kun det godkendte udfald bogfører penge. Sandboxens bogføring er rigtig bogføring på testorganisationens klientmidler. Svindelværnet er heller ikke slået fra: for mange afviste forsøg på samme reference giver 422 fraud_guard_blocked — se det her, før dine kunder gør.

409 gateway_simulator_unavailable betyder, at din sandbox taler med gatewayens eget testmiljø i stedet for Riecks simulator; dér spiller testkortene på den hostede betalingsside de samme roller, og callbacks kommer af sig selv. Capture-, refusions- og annulleringsafvisninger er senere operationer og får deres sandbox-vej sammen med de flader, der udløser dem.

Fejlkoder: 401 betyder TO ting — en død nøgle og en gyldig nøgle uden den nødvendige rettighed. Beskeden er forskellen, ikke statuskoden.