# Final capture

Capture the final part of funds from an initial authorisation and mark it as fully captured.

## Fully capture a transaction

/v1/transactions/{systemTransactionId}/modifications

### Request example

Use the following request to fully capture an authorised transaction.


```json
{
  "fundingType": "Card",
  "merchant": "MERCHANT-1",
  "site": "SITE-1",
  "merchantTransactionId": "TRANSACTION-2",
  "merchantTransactionDate": "2025-01-27T08:51:02.826Z",
  "amounts": {
    "transaction": 24.99
  },
  "operation": "FinalCapture"
}
```

| 
| Parameter | Description |
| `fundingType`string (enum) | The type of funding source used for the transaction.Possible values:`Card``Paypal` |
| `merchant`string (≤ 20 characters) | Your unique merchant identifier, as assigned by PXP. |
| `site`string (≤ 20 characters) | Your unique site identifier, as assigned by PXP. |
| `merchantTransactionId`string (≤ 50 characters) | The unique identifier for this transaction, as chosen by you. |
| `merchantTransactionDate`date-time | The date and time when the initial transaction happened, in ISO 8601 format. |
| `amounts`object | Details about the transaction amount. |
| `amounts.transaction`string | The value of the transaction. This can't be more than the original transaction value. |
| `amounts.gratuity`number | The gratuity or tip amount. |
| `operation`string | The type of modification that you want to make. Set this to `FinalCapture`.Possible values:`Capture``FinalCapture``Refund``Incremental` `Void` |
| `remark`string | Optional remark or note about the modification. |
| `data`object | Optional key-value pairs for additional data. |
| `dccData`object | Details about the Dynamic Currency Conversion (DCC). |
| `dccData.rateSelectedIndicator`string (enum) | Whether a DCC rate was selected for the transaction.Possible values:`NotSelected``Selected``NotAvailable``CardNotEligible``Error` |
| `dccData.amounts`object | Details about the transaction amount in the local currency and the cardholder's currency. |
| `dccData.amounts.local`string | Details about the transaction amount in the local currency. |
| `dccData.amounts.local.transaction`number | The transaction amount in the local currency. |
| `dccData.amounts.local.currencyCode`string | The currency code in ISO 4217 format. |
| `dccData.amounts.cardholder`object | Details about the transaction amount in the cardholder's currency. |
| `dccData.amounts.cardholder.transaction`number | The transaction amount in the cardholder's currency. |
| `dccData.amounts.cardholder.currencyCode`string | The currency code in ISO 4217 format. |
| `dccData.exchangeRate`number | The exchange rate used for the DCC. |
| `dccData.providerData`object | Details about the DCC provider. |
| `dccData.providerData.provider`string | The name of the DCC provider. |
| `dccData.providerData.referenceId`string | The reference ID provided by the DCC provider. This is required if your provider is Elavon, otherwise it's ignored. |
| `dccData.providerData.merchantId`string | The merchant ID assigned by the DCC provider. This is required if your provider is Elavon, otherwise it's ignored. |
| `dccData.providerData.terminalId`string | The terminal ID assigned by the DCC provider. This is required if your provider is Elavon, otherwise it's ignored. |
| `dccData.providerData.markupTextIndicator`integer | The mark-up text indicator for the DCC provider. |
| `dccData.markupRate`number or null | The mark-up rate. |
| `dccData.disclaimer`string or null | The disclaimer text. |


### Response example

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.


```json
{
  "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",                   		     
    "maskedPrimaryAccountNumber": "526600******0075",
    "expiryMonth": "12",
    "expiryYear": "2031",
    "gatewayTokenId": "5fbd77ce-02c1-40ed-94bc-1016660b7512",
    "providerResponse": {
      "provider": "pxpfinancial",
      "merchantAdvice": {}
    }
  }
}
```