PaymentStatusUpdate

Update transaction status

This endpoint allows a Creditor Agent to update a card payment instruction.

put/creditor-agents/{ica}/payment-acceptances/{instruction_identification}

Request

Base URL
https://api.mastercard.com/commercial/payments
Auth
none declared
TypeScript
https://skmtc.dev/mastercard/apis/payment-acceptance-api/docs/creditor-agents/:ica/payment-acceptances/:instruction_identification/put.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

icastring required

Interbank Card Association ID

instruction_identificationstring required

Unique Identification for each Payment Instruction

Request body

Possible status while Creditor updating the payment status- APPROVED DECLINED REJECTED SETTLED CANCELLATION_ACCEPTED CANCELLATION_REJECTED

Example request

{
  "status": "CANCELLATION_REJECTED",
  "settlementTimeIndication": {
    "creditDateTime": "2025-08-17T17:37:23.230Z",
    "debitDateTime": "2025-08-17T17:37:23.231Z"
  },
  "transactionIdentification": {
    "approvalCode": "214636",
    "retrievalReferenceNumber": "54946469666",
    "transactionReference": "4494944994949",
    "transactionDateTime": "2025-02-13T11:32:28.028Z"
  },
  "statusReasonInformation": [
    {
      "description": "Transaction {transactionId} cancellation rejected. {paymentMethod} payment was processed already.",
      "reasonCode": "PAYMENT_PROCESSED"
    }
  ]
}

Response

Successful (no content)

Changes

No recorded changes to this operation across all 1 revision of this API.