Capture the final part of funds from an initial authorisation and mark it as fully captured.
Use the following request to fully capture an authorised transaction.
{
"merchant": "MERCHANT-1",
"site": "SITE-1",
"merchantTransactionId": "TRANSACTION-2",
"merchantTransactionDate": "2025-01-27T08:51:02.826Z",
"amounts": {
"transaction": 24.99
},
"operation": "Capture"
}| Parameter | Description |
|---|---|
merchantstring (≤ 20 characters) required | Your unique merchant identifier, as assigned by PXP. |
sitestring (≤ 20 characters) required | Your unique site identifier, as assigned by PXP. |
merchantTransactionIdstring (≤ 50 characters) required | The unique identifier for this transaction, as chosen by you. |
merchantTransactionDatedate-time required | The date and time when the initial transaction happened, in ISO 8601 format. |
amountsobject required | Details about the transaction amount. |
amounts.transactionstring required | The value of the transaction. This can't be more than the original transaction value. |
operationstring required | The type of modification that you want to make. Set this to FinalCapture.Possible values:
|
If your request is successful, you'll receive a 200 request 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-03-27T10:10:28.302Z",
"merchantTransactionId": "66e9b08f-6609-43f7-be87-6fcff16c6168",
"systemTransactionId": "196d03e8-9f66-48d7-bde3-764447951afb",
"fundingData": {
"cardScheme": "MasterCard",
"primaryAccountNumber": "526600******0075",
"expiryMonth": "12",
"expiryYear": "2031",
"gatewayTokenId": "5fbd77ce-02c1-40ed-94bc-1016660b7512",
"providerResponse": {
"provider": "pxpfinancial",
"merchantAdvice": {}
},
"processorTransactionId": "3494f819-4bc6-4129-b3b1-01430b317336"
}
}