post https://api.sandbox.midtrans.com/v2/capture
Capture transaction is triggered to capture the transaction balance when transaction_status:authorize. This is only available after Pre-Authorized Credit Card or Pre-Authorized GoPay.
Capture Transaction Method
See sample on the right -- try it yourself!
| HTTP Method | Endpoint | Definition |
|---|---|---|
| POST | BASE_URL/v2/capture | Capture an authorized transaction for card payment. |
Capture Transaction Request
{
"transaction_id": "be4f3e44-d6ee-4355-8c64-c1d1dc7f4590",
"gross_amount": 145000
}
| JSON Attribute | Description | Type | Required |
|---|---|---|---|
| transaction_id | Transaction ID given by Midtrans. | String(255) | Required |
| gross_amount | Total amount of transaction in IDR. By default it captures whole transaction amount. Note: Decimal values are invalid. | Long | Optional |
Capture Transaction Response
{
"status_code" : "200",
"status_message" : "Success, Credit Card capture transaction is successful",
"transaction_id" : "ca297170-be4c-45ed-9dc9-be5ba99d30ee",
"masked_card" : "45111111-1117",
"order_id" : "testing-0.4555-1414741517",
"payment_type" : "credit_card",
"transaction_time" : "2014-10-31 14:46:44",
"transaction_status" : "capture",
"fraud_status" : "accept",
"bank" : "bni",
"gross_amount" : "30000.00"
}
{
"status_code" : "412",
"status_message" : "Merchant cannot modify the status of the transaction"
}
| JSON Attribute | Description | Type |
|---|---|---|
| status_code | Status code of transaction capture result. | String |
| status_message | Description of transaction capture result. | String |
| order_id | Order ID specified by you. | String |
| transaction_id | Transaction ID given by Midtrans. | String |
| masked_card | First 8-digits and last 4-digits of customer's card number. | String |
| gross_amount | Total amount of transaction in IDR. | String |
| order_id | Order ID specified by you. | String |
| payment_type | The payment method used by the customer. | String |
| transaction_time | Timestamp of transaction in ISO 8601 format. Time Zone: GMT+7. | String |
| transaction_status | Transaction status after capture card transaction. | String |
| fraud_status | Detection result by Fraud Detection System (FDS). Possible values areaccept : Approved by FDS.deny: Denied by FDS. Transaction automatically failed. | String |
| bank | The name of the acquiring bank. | String |
| gross_amount | Total amount of transaction in IDR. | String |