Execute the Preauth Transaction to move funds

In the previous step, we created a Preauth Transaction to store the details of a future transaction.

In this step, we will now capture a preauthorized transaction, creating an Aeropay Transaction where funds will be moved.

The id of the Preauthorized Transaction object is included in the body to specify the preauthorizedTransaction being captured. Once captured, you will receive the id of the Aeropay Transaction object.

👍

Point of Sale (POS) Integrations

If you're using Aeropay preauthorized transactions for purchases with an point of sale (POS), we recommend listening to a callback from the POS that the order has been completed to trigger the call to Aeropay's POST /capturePreauthTransaction

Step 6A - Capture the Preauth Transaction

HTTP request

Sandbox - POST https://staging-api.aeropay.com/capturePreauthTransaction
Production - POST https://api.aeropay.com/capturePreauthTransaction

Request parameters

Error Codes

Code Example - Request

curl --request POST \
     --url https://staging-api.aeropay.com/capturePreauthTransaction \
     --header 'Content-Type: application/json' \
     --header 'accept: application/json' \
     --header 'authorizationToken: Bearer {{token}}' \
     --data '{"id":"1234"}'

Code Example - Response

{
    "success": true,
    "error": null,
    "amount": 1100,
    "merchantId": "582",
    "attributes": [],
    "uuid": "994e327c-4573-4ad6-b3d7-b873cda7f82a",
    "transactionId": "231634",
    "customerName": "John Doe",
    "status": "pending",
    "merchantName": "Aeropay"
}

👍

This creates an Aeropay transaction with a new, separate id, to the merchant and with the amount specified in the preauth.

This mirrors the outcome of the /transaction POST endpoint

Step 6B - Handle Webhooks

If you have an active webhook subscription, you will receive the transaction_completed webhook immediately after the resource has been created.

📘

To create a webhook subscription, visit our API Reference

Refer to this page