Final capture

Capture the final part of funds and mark an authorisation as completely captured.

Fully capture a transaction

POST

/v1/pos-transactions/{systemTransactionId}/modifications

Request example

Use the following request to perform a final capture.

{
  "merchant": "MERCHANT-1",
  "site": "SITE-1",
  "merchantTransactionId": "POS_002",
  "merchantTransactionDate": "2025-01-27T08:51:02.826Z",
  "amounts": {
    "transaction": 24.99,
    "currencyCode": "GBP",
    "gratuity": 0
  },
  "operation": "FinalCapture"
}

Path parameters

Parameter	Description
`systemTransactionId` string (36 characters) required	The unique identifier for the original transaction, as assigned by PXP.

Body parameters

Parameter	Description
`merchant` string (≤ 20 characters) required	Your unique merchant identifier, as assigned by PXP.
`site` string (≤ 20 characters) required	Your unique site identifier, as assigned by PXP.
`merchantTransactionId` string (≤ 50 characters) required	The unique identifier for this transaction, as chosen by you.
`merchantTransactionDate` date-time required	The date and time when the initial transaction happened, in ISO 8601 format.
`amounts` object required	Details about the transaction amount.
`amounts.transaction` string required	The value of the transaction. For `Void` operations, this should match the original transaction value.
`amounts.currencyCode` string required	The currency code associated with the transaction, in ISO 4217 format.
`amounts.gratuity` number	The optional gratuity amount.
`operation` string required	The type of modification that you want to make. Set this to `FinalCapture`. Possible values: `Capture` `FinalCapture` `Refund` `Incremental` `Void`

Response example

If your request is successful, you'll receive a 200 response containing a new systemTransactionId. The state will also be updated to Captured. You'll also receive a Transaction (Card Captured) webhook notification.

{
  "state": "Captured",
  "stateData": {},
  "merchantTransactionDate": "2025-08-26T16:37:49.546Z",
  "merchantTransactionId": "a716e1f4-373c-4d2e-b731-1b92e9aa6b1c",
  "systemTransactionId": "9dbee2ec-5120-48aa-a58a-98ac7fbd54ac",
  "fundingData": {
    "cardScheme": "MasterCard",
        "primaryAccountNumber": "526600******0075",
        "expiryMonth": "12",
        "expiryYear": "2031",
        "gatewayTokenId": "5fbd77ce-02c1-40ed-94bc-1016660b7512",
        "providerResponse": {
            "provider": "pxpfinancial",
            "merchantId": "7171910017",
            "terminalId": "82809409",
            "merchantAdvice": {}
        },
        "processorTransactionId": "5abfdaad-4c48-4e78-86e7-66d27cc57172"
    }
}