Capturing a Payment
Copy page
Copy page as Markdown for LLMs
Open in ChatGPT
Ask questions about this page
Open in Claude
Ask questions about this page
Capture is used after authorizing a payment, as authorization alone doesn't transfer the funds it only puts them on hold. To complete the transaction and move the money to your account, the payment must be captured within a set timeframe usually 5-7 days maximum.
Amazon Payment Services provides merchants with flexible options to capture payments according to their business needs and technical capabilities. You can choose the method that best suits your workflow and integration requirements.
Prerequisites
Before capturing a payment, ensure you have:
-
Valid Authorization
The payment must be in an authorized state with a valid merchant reference or Fort ID from the original authorization transaction. -
Security Credentials
Retrieve your integration credentials from the merchant dashboard:- Log into your Amazon Payment Services account
- Navigate to Merchant Management → Security Settings
- Save the following values:
- Access Code - Authentication token for API requests
- Merchant Identifier - Your unique merchant ID
- SHA Request/Response - Keys for signature calculation
Capture Methods
Dashboard
Capture payments manually using the merchant dashboard
API
Integrate payment capture using our APIs
Batch
Process captures at once by uploading a batch file
Through the Dashboard
You can use Amazon Payment Services dashboard to capture a payment by following these steps:
Access Transaction Management
Login to your Amazon Payment Services account and navigate to Order Transaction Management tab.
Search for Transaction
Search for the transaction you need to capture by using its merchant reference or fort ID.
Capture Payment
Choose Capture from the Action button on the right. Enter the amount you need to capture (either partial or full), then click on Confirm.
The system will not allow you to capture an amount larger than the authorized amount.
Through the API
For more advanced options, you can use our capture API. Requests should be sent as POST JSON from the backend.
API Endpoints
https://sbpaymentservices.PayFort.com/FortAPI/paymentApi
Request Sample
{
"command": "CAPTURE",
"access_code": "s4lwuuoY5upZlZY5D6dr",
"merchant_identifier": "WeVJHPYm",
"merchant_reference": "Test",
"amount": "300",
"currency": "AED",
"language": "en",
"signature": "{{signature}}"
}
Make sure merchant reference value matches the merchant reference used in the original authorization request.
Refer to our Signature Calculation Guide for detailed implementation instructions and code examples.
Response Sample
{
"response_code": "04000",
"amount": "100",
"signature": "d9c7e2dd9fabd8c224612172be506415b8b1e5067a6c307b237b2d9bce18bc26",
"merchant_identifier": "WeVJHPYm",
"access_code": "s4lwuuoY5upZlZY5D6dr",
"language": "en",
"fort_id": "169996200024059857",
"command": "CAPTURE",
"response_message": "Success",
"merchant_reference": "Test",
"currency": "AED",
"acquirer_response_code": "00",
"status": "04"
}
Multiply your transaction amount by the currency decimal code per ISO code 3 before sending the amount parameter. For currencies with three-decimal codes, round VISA transactions to zero in the final decimal place to avoid declined transactions. Example For 500 AED (2 decimal places per ISO code 3), multiply by 100 to send 50000 in your request.
To get a detailed view of all required and optional fields, see our API reference.
Check transaction status
To check the transaction status, check the Check a Transaction Status section.
Handling the response
If you have a webhook, check the webhook section to understand how we send transaction responses to your system.
Through Batch
To bulk capture payments, you need to upload a batch file for automated capture.
Visit Batch section to learn more.