---
title: "Update transaction status"
method: PUT
path: "/creditor-agents/{ica}/payment-acceptances/{instruction_identification}"
tags: ["PaymentStatusUpdate"]
---

# Update transaction status

`PUT /creditor-agents/{ica}/payment-acceptances/{instruction_identification}`

## Request

- Base URL: `https://api.mastercard.com/commercial/payments`
- URL: `https://api.mastercard.com/commercial/payments/creditor-agents/{ica}/payment-acceptances/{instruction_identification}`
- 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)

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

## Path parameters

- `ica` string, required
- `instruction_identification` string, required

## Request body

- CreditorPaymentStatusUpdate: Specifies the Creditor payment update status of the payment information.
  - `status` 'APPROVED' | 'DECLINED' | 'REJECTED' | 'SETTLED' | 'CANCELLATION_ACCEPTED' | 'CANCELLATION_REJECTED', required: Possible status while Creditor updating the payment status- APPROVED DECLINED REJECTED SETTLED CANCELLATION_ACCEPTED CANCELLATION_REJECTED
  - `settlementTimeIndication` SettlementTimeIndication
    - `creditDateTime` string: Date and time at which a payment has been credited.
    - `debitDateTime` string: Reserved for Future Use
  - `transactionIdentification` TransactionIdentification
    - `approvalCode` string: The value assigned by the approval entity indicating approval.
    - `retrievalReferenceNumber` string: Reference supplied by the system retaining the original source information and used to assist in locating that information or a copy thereof.
    - `transactionReference` string: Identification of the transaction by the card acceptor. It may appear on the receipt of the cardholder. It remains unchanged throughout the lifetime of the transaction.
    - `transactionDateTime` string: Local date and time of the transaction assigned by the POI (Point Of Interaction)
  - `statusReasonInformation` CreditorStatusReasonInformationUpdate[]: Status Reason Information
    - `description` string: Specifies the reason for the status report. Refer to the developer portal for the full list.
    - `reasonCode` string: Specifies the reason code for the status report. Refer to the developer portal for the full list.

## Response `200`

Successful (no content)

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Access Denied

---

[API](https://skmtc.dev/mastercard/apis/payment-acceptance-api.md) - [All operations](https://skmtc.dev/mastercard/apis/payment-acceptance-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mastercard/apis/payment-acceptance-api/revisions/baa0a0739572?raw)