Authorize & Capture

​

Pre-Authorize (Hold Funds)

• Submit a card token, amount, currency, and gateway credentials ID.
• PCI Booking detokenizes and forwards the authorization to the PSP.
• The PSP places a hold on the funds and returns an authorization reference.
• No funds are transferred yet.

curl -X POST "https://service.pcibooking.net/api/paymentGateway?credentialsId=my-stored-credentials" \
  -H "Authorization: APIKEY your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "CardToken": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
    "OperationType": "PreAuth",
    "Amount": 250.00,
    "Currency": "EUR"
  }'

​

Capture (Settle Funds)

• Submit the original transaction reference and the amount to capture.
• The capture amount can be equal to or less than the authorized amount.
• PCI Booking forwards the capture to the PSP, which transfers the funds.

curl -X POST "https://service.pcibooking.net/api/paymentGateway?credentialsId=my-stored-credentials" \
  -H "Authorization: APIKEY your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "CardToken": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
    "OperationType": "Capture",
    "GatewayReference": "txn_abc123",
    "Amount": 250.00,
    "Currency": "EUR"
  }'

​

When to Use

• Hotels and travel. Authorize at booking, capture at checkout.
• Rentals. Authorize at pickup, capture at return.
• E-commerce. Authorize at order, capture at shipment.
• Partial captures. Capture less than the authorized amount if the final total changes.

​

Next Steps