ALalfredpay
Refunds

Unwind a conversion

Changed on

Reverses a conversion that hasn't reached a terminal state.

Raised before execution, it releases the lock and the sell-side balance. Raised in flight, it unwinds and returns the source value to the originating balance. Either way it creates no new conversion.

Wait on refund.updated. See Webhooks and events.

post/v1/conversions/{conversionId}/refund

Request

  • Base URL
    https://api.sandbox.alfredpay.io
  • URL
    https://api.sandbox.alfredpay.io/v1/conversions/{conversionId}/refund
  • Auth
    • HTTP bearer
    • or API key in header api-key and API key in header api-secret

Headers

Idempotency-Keystring uuid required

Required on every state-changing POST, simulators included; the only exempt POST is …/verifications/preflight. Replay (same key, same body) returns the original response with Idempotent-Replayed: true; same key with a different body → 409 idempotency_conflict. Keys are UUIDs, scoped to the API key, retained for 24 hours.

Response

Accepted

actionIdstring
actionType'REFUND'
parentTransactionIdstring
status'REQUESTED' | 'PROCESSING' | 'COMPLETED' | 'DECLINED'
parentOutcome'CANCELLED' | 'null' nullable

The parent lands CANCELLED whether unwound pre-execution or returned after a leg went out.

createdAtstring date-time
updatedAtstring date-time

Changes