# Capture Transaction

Capture transaction means that the user approve / approve credit card transactions that have been verified bank (authorize transactions), the merchant then sends a request to capture the transaction to receive and collect the payments to customers who registered on the credit card used. Requests capture can only be made for transactions already in the authorize by the bank (field TXN\_STATUS = A). In some banks already provide services for the automation of the capture process that can be set in accordance with merchant demand.

**Request Parameter Capture Transaction**

Request parameter capture the transaction is a parameter that must be provided by the merchant system to be able to capture transactions through the system Faspay.

{% tabs %}
{% tab title="Request" %}

<table><thead><tr><th width="188">Parameter</th><th width="134">Data Type</th><th width="93" align="center">M/O/C</th><th width="300">Description</th></tr></thead><tbody><tr><td>transaction_type</td><td>Integer(2)</td><td align="center">M</td><td>For capture transaction API, always used value ‘2’</td></tr><tr><td>merchant_id</td><td>Varchar(30)</td><td align="center">M</td><td>Your Faspay Merchant ID.</td></tr><tr><td>merchant_tranid</td><td>Varchar(100)</td><td align="center">M</td><td>Merchant’s unique transaction id as passed in from the
 payment request.</td></tr><tr><td>transaction_id</td><td>Varchar</td><td align="center">O</td><td>Transaction ID generated by Faspay. Fill this parameter with transaction_id provided in return_url or callback_url when payment occur.</td></tr><tr><td>amount</td><td>Varchar(10)</td><td align="center">M</td><td>Transaction amount as passed in from the payment
 request.</td></tr><tr><td>signature</td><td>Varchar(40)</td><td align="center">M</td><td>Transaction signature of request for data integrity check.</td></tr></tbody></table>
{% endtab %}

{% tab title="Sample Request" %}

```php
{
 "transaction_type" : 2,
 "merchant_id": "auto_store",
 "merchant_tranid": "AGS028",
 "transaction_id": "477DC7E5-D26B-46C5-AF39-61D8B47310AB",
 "amount": "20000.00",
 "signature" : "56c4c92226047a620374f4829d8058a5f955d684"
}
```

{% endtab %}
{% endtabs %}

**Response Parameter Capture Transaction**

Response transaction capture parameters are parameters that will be delivered by the system in response to a request Faspay capture parameter transaction that has been submitted by the merchant system. If no parameters are not appropriate / value is incorrect, the transaction will be rejected in the system Faspay.

{% tabs %}
{% tab title="Response" %}

<table><thead><tr><th width="188">Parameter</th><th width="134">Data Type</th><th width="93" align="center">M/O/C</th><th width="300">Description</th></tr></thead><tbody><tr><td>merchant_id</td><td>Varchar(30)</td><td align="center">M</td><td>Your Faspay Merchant ID.</td></tr><tr><td>merchant_tranid</td><td>Varchar(100)</td><td align="center">M</td><td>Merchant’s own assigned transaction id as passed in
 from the request.</td></tr><tr><td>tnx_status</td><td>Varchar(3)</td><td align="center"></td><td>Transaction status from Faspay.
<br>A – Authorized
<br>S – Sales
<br>C – Captured
<br>CF – Capture Failed
<br>F – Failed
<br>E – Error
<br>B – Blocked
<br>N – Pending
<br>V – Void</td></tr><tr><td>amount</td><td>Varchar(10)</td><td align="center">M</td><td>Transaction amount as passed in from the request.</td></tr><tr><td>transaction_id</td><td>Varchar</td><td align="center">M</td><td>Transaction ID generated by Faspay when payment
 occur-Occur.</td></tr><tr><td>signature</td><td>Varchar(40)</td><td align="center">M</td><td>Transaction signature of request for data integrity check.</td></tr><tr><td>tran_date</td><td>Varchar(19)</td><td align="center">C</td><td>Transaction date of when transaction is submitted to
 Faspay e-Payment. Date format in ‘DD-MM-YYYY
 hh:mm:ss’ e.g. 24-05-2024 08:24:23 In the event of
 error, this field may be empty.</td></tr><tr><td>response_code</td><td>String(7)</td><td align="center">M</td><td>Response code.</td></tr></tbody></table>
{% endtab %}

{% tab title="Sample Response" %}

```php
{
 "merchant_id": "auto_store",
 "merchant_tranid": "AGS008",
 "txn_status": "C",
 "amount": "10000.00",
 "transaction_id": "0AFEAC6A-7FA7-4F4C-B6EA-B1FD5D2D9161",
 "signature": "09FB66982A1ED05122581951F9BDBAF7AC3B6CF9",
 "tran_date": "2024-09-04 14:39:29",
 "response_code": "00",
 "response_message": "Success"
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.faspay.co.id/merchant-integration/api-reference-1/credit-card-transaction/additional-api-integration/capture-transaction-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.