Retry Transaction

POST

/api/Transactions/{id}/retry

curl --request POST \
  --url https://example.com/api/Transactions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/retry \
  --header 'Authorization: Bearer <token>' \
  --header 'Idempotency-Key: example'

Retries a declined transaction by sending a new charge to the payment gateway using the same payment method. A new transaction record (with its own reference) is created. The original is left unchanged. If the charge belonged to a subscription billing period, a successful retry marks that period paid so it isn’t collected again.

Authorizations

• Bearer

Parameters

Path Parameters

id

required

string format: uuid

The original transaction’s identifier.

Header Parameters

Idempotency-Key

required

string

<= 255 characters

Required. A unique value (a UUID is ideal) per logical operation; reuse it when retrying that operation. A retry with the same key and body replays the original response instead of running twice. A 4xx frees the key, so the operation can be corrected and retried on it. A 5xx does not: the attempt may already have moved money, so retries with that key replay a problem+json saying the outcome is unknown, and a genuinely fresh attempt needs a new key. Missing → 400.

Responses

201

New transaction record for the retry attempt.

Media type application/json

object

id

string format: uuid

merchantId

string format: uuid

memberId

string format: uuid

nullable

memberName

string

nullable

subscriptionId

string format: uuid

nullable

invoiceId

string format: uuid

nullable

paymentMethodId

string format: uuid

nullable

status

string

Allowed values: Processing Approved Declined Refunded Voided

amount

number format: double

currency

string

nullable

reference

string

nullable

description

string

nullable

declineCode

string

nullable

cardInfo

string

nullable

processedAt

string format: date-time

nullable

createdAt

string format: date-time

updatedAt

string format: date-time

Example

{
  "status": "Processing"
}

404

No transaction with the given ID exists.

Media type application/json

object

type

string

nullable

title

string

nullable

status

integer format: int32

nullable

detail

string

nullable

instance

string

nullable

key

additional properties

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

409

Retrying could double charge: the transaction isn’t declined, an earlier retry of it succeeded or is still processing, or its billing period is already paid, settling or written off.

Media type application/json

object

type

string

nullable

title

string

nullable

status

integer format: int32

nullable

detail

string

nullable

instance

string

nullable

key

additional properties

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}