APG PayAPG Paydocs

Card issuer

Update issuer transaction

PATCH/issuer-transactions/{issuerTransactionId}

Capture, void, dispute, refund or adjust an issuer transaction, or append metadata to it.

3 actionsItxnUpdateAppendMetadataItxnUpdateAppendRefundMetadataItxnUpdateRevalidate

Permissions

Required permission
issuerTransactions:update

Requires the `update` action on `issuerTransactions` for the supplied runtime context

Path parameters

issuerTransactionIdstring
required

Request body

This body is a typed union. Pick a variant to see its fields and a matching example.

Discriminated by type
type = "ItxnUpdateAppendMetadata"
metadatamap of any JSON valuerequired

Free-form data the platform stores and returns untouched. Values may be nested objects and arrays.

curl -X PATCH https://api.tst.au.apgpay.dev/issuer-transactions/{issuerTransactionId} \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "ItxnUpdateAppendMetadata",
  "metadata": {
    "yourKey": {}
  }
}'

Responses

The response is a tagged shape: type is always "ItxnUpdateRspAttributes". Switch on it; subtypes can be added, and a client that already reads it will not break.

Discriminated by type
type = "ItxnUpdateRspAttributes"

The resource as it stands after the change.

Example
{
  "type": "ItxnUpdateRspAttributes",
  "updated": {
    "type": "ItxnViewAttributes",
    "issuerTransactionId": "itxn_9f2Kd8QpLzXw",
    "status": "Authorised",
    "network": "Uatp",
    "card": {
      "type": "ItxnCardAttributes",
      "cardId": "dcard_9f2Kd8QpLzXw",
      "cardReference": "your-own-reference",
      "last4": "4242",
      "bin": "424242",
      "brand": "Visa",
      "expiryMonth": 6,
      "expiryYear": 2029,
      "country": "AU",
      "cardHolderName": "Ada Lovelace"
    },
    "amounts": {
      "type": "ItxnAmountsAttributes",
      "currency": "AUD",
      "authorised": 1250,
      "captured": 1250,
      "refunded": 1250
    },
    "refundedBeforeConversion": {
      "type": "IsoCurrencyAmount",
      "minorCurrencyUnits": 1250,
      "currency": "AUD"
    },
    "refunds": [
      {
        "type": "ItxnRefundAttributes",
        "refundId": "rfnd_9f2Kd8QpLzXw",
        "referenceRefundId": "your-own-reference",
        "status": "Authorised",
        "amounts": {
          "type": "ItxnRefundAmountsAttributes",
          "currency": "AUD",
          "amount": 1250,
          "tax": 1250,
          "taxType": "string"
        },
        "taxRate": 0.9412,
        "originalAmount": {
          "type": "IsoCurrencyAmount",
          "minorCurrencyUnits": 1250,
          "currency": "AUD"
        },
        "metadata": {
          "yourKey": {}
        },
        "publishedMetadata": {
          "yourKey": {}
        },
        "customerStatementIssueDate": "2026-08-19",
        "processingDate": "2026-08-19",
        "publishedAt": "2026-08-19T04:21:07Z",
        "createdAt": "2026-08-19T04:21:07Z",
        "updatedAt": "2026-08-19T04:21:07Z"
      }
    ],
    "disputes": [
      {
        "type": "ItxnDisputeAttributes",
        "disputeId": "dispute_9f2Kd8QpLzXw",
        "referenceDisputeId": "your-own-reference",
        "outcome": "Pending",
        "amount": {
          "type": "IsoCurrencyAmount",
          "minorCurrencyUnits": 1250,
          "currency": "AUD"
        },
        "reason": "Requested by the customer.",
        "metadata": {
          "yourKey": {}
        },
        "createdAt": "2026-08-19T04:21:07Z",
        "updatedAt": "2026-08-19T04:21:07Z"
      }
    ],
    "acquiringMerchant": {
      "type": "ItxnAcquiringMerchantAttributes",
      "name": "Ada Lovelace",
      "merchantCategoryCode": "string",
      "iataNumber": "string",
      "taxId": "string",
      "country": "AU",
      "city": "string",
      "postCode": "3000",
      "emailAddress": "ada@example.com",
      "phoneNumber": "+61400000000"
    },
    "description": "string",
    "loanId": "loan_9f2Kd8QpLzXw",
    "loanTransactionId": "ltxn_9f2Kd8QpLzXw",
    "settlementMerchantId": "mcht_9f2Kd8QpLzXw",
    "referenceTransactionId": "your-own-reference",
    "auditNumber": "string",
    "approvalCode": "string",
    "metadata": {
      "yourKey": {}
    },
    "authorisedAt": "2026-08-19T04:21:07Z",
    "capturedAt": "2026-08-19T04:21:07Z",
    "transactedAt": "2026-08-19T04:21:07Z",
    "createdAt": "2026-08-19T04:21:07Z",
    "updatedAt": "2026-08-19T04:21:07Z"
  }
}

Error responses