Capture

This transaction captures the money previously held by the corresponding authorization transaction. As a result, the issuing bank credits the funds to the merchant's bank account and updates the cardholder's statement. Card regulations require a merchant to ship goods before settling the funds for an order.

---

Request

To initiate a capture transaction, send a POST request to https://gateway.moqpay.com/transactions/captures with the following parameters:

Parameter	Type	Description
parent_uid * required	string	A UID of the authorization transaction.
amount * required	bigInteger	An amount to capture in minimal currency units, for example 1000 for $10.00.
duplicate_check	boolean	The parameter controls whether the payment gateway will do a duplicate check of the received capture requests. By default, it is set to true and the duplicate request with the same parent_uid and amount sent within 30 seconds after the first request will be rejected.

Example of the request

{
  "request":{
    "parent_uid":"1-310b0da80b",
    "amount":50
  }
}

Response

Parameter	Type	Description
transaction * required	object
uid * required	string	A UID of the processed transaction.
status * required	string	A status of the processed transaction.
message * required	string	A processing result message corresponding to the processing code (code). In certain integration options, this parameter contains the processing result message provided by the acquirer and has the same value as the capture.message (or transaction.message for API v.3).
type * required	string	A transaction type.
receipt_url * required	string	A transaction receipt URL.
code * required	string	Transaction processing code .
friendly_message * required	string	code description for the customer.

Example of the response

{
    "transaction": {
        "uid": "52bfc29a-2c2f-408a-a7d5-bd8e84a320a9",
        "status": "successful",
        "amount": 460,
        "currency": "EUR",
        "type": "capture",
        "message": "Successfully processed",
        "test": true,
        "created_at": "2024-04-02T12:07:14.881Z",
        "updated_at": "2024-04-02T12:07:20.028Z",
        "paid_at": "2024-04-02T12:07:19.955Z",
        "closed_at": null,
        "settled_at": null,
        "manually_corrected_at": null,
        "parent_uid": "4298aabd-9547-46fa-a151-66c29489c157",
        "receipt_url": "https://backoffice.moqpay.com/customer/transactions/52bfc29a-2c2f-408a-a7d5-bd8e84a320a9/580262bb7b11a467fd85aa1c22f3c4afb4150511533c086b55eb7e53f81f4727?language=en",
        "status_code": null,
        "mute_notifications": null,
        "id": "52bfc29a-2c2f-408a-a7d5-bd8e84a320a9",
        "code": "S.0000",
        "friendly_message": "The operation is successful.",
        "smart_routing_verification": {
            "status": "successful"
        },       
        "capture": {
            "message": "Capture was approved",
            "ref_id": "8889912",
            "rrn": null,
            "auth_code": null,
            "bank_code": "05",
            "gateway_id": 3483,
            "status": "successful"
        }
    }
}