Capture

A capture is used after a transaction of an authorization. It is used to transfer the authorized funds from the customer's account to the merchant account.

POST /v1/payments/:id/capture

curl -X POST 'https://api.firstoken.co/v1/payments/:id/capture' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR API KEY' \
--data '{
  "transaction_info": {
    "type": "capture",
    "reference_code": "123456789"
  },
  "capture_info": {
    "amount_details": {
      "total_amount": 1000,
      "currency": "COP"
    },
    "installments": 1
  },
  "device_info": {
      "ip_address": "12.7.8.120"
  }
}
Example of the JSON response
{
    "status": "success",
    "message": "Capture successful",
    "data": {
        "transaction_info": {
            "type": "capture_response",
            "reference_code": "123456789",
            "transaction_id": "0001708980791641783622",
            "request_id": "7089807930896719904951",
            "status": "Pending",
            "reconciliation_id": "7089807826426366604953",
            "created_at": "2024-02-26T20:53:13Z"
        },
        "order_info": {
            "amount_details": {
                "total_amount": "1000.00",
                "currency": "COP"
            }
        }
    }

Last updated

Was this helpful?