On This Page
Capture Service
The capture service is a follow-on service that uses the request ID returned from the
previous authorization. The request ID links the capture to the authorization. This
service transfers funds from the customer’s account to your bank and usually takes two
to four days to complete.
Payment Processor | Authorization and Capture Information |
|---|---|
For USD, limits authorization
and capture amounts to 9,999,999.00. For other currencies, the
maximum amount depends on the currency. Contact American Express
for the maximum amounts for the currencies that you are using.
Regardless of exponent or currency, the maximum number of digits
for the amount value is 12 digits. | |
FDMS South | For the Indonesian rupiah (IDR) and Chilean peso (CLP)
currencies:
|
Required Fields for Capturing a Payment
The following fields are required when creating a capture request:
- clientReferenceInformation.code
- orderInformation.amountDetails.currency
- orderInformation.amountDetails.totalAmount
- processingInformation.paymentSolution
- Set to008.
Capturing a Payment
- Pass the original authorization ID in the URL, and send the service request toPOST https://<. Use one of these URL prefixes:url_prefix>/v2/payments/{id}/captures
- Test:
- Production:
ADDITIONAL INFORMATION
Whereidis the authorization ID returned in the authorization response.{ "id": "6481692924466004003001" }The URL with theidvalue is included in the authorization response:{ "_links": { "capture": { "method": "POST", "href": "/pts/v2/payments/6481692924466004003001/captures" } } - Check the response message to make sure that the request was successful. A 200-level HTTP response code indicates success. For information about response codes, see .
Example: Basic Credit Card Capture Using the REST
API
Capture Request
{ "clientReferenceInformation": { "code": "482046C3A7E94F5BD1FE3C66C" }, "processingInformation": { "paymentSolution": "008" }, "orderInformation": { "amountDetails": { "totalAmount": "49.95", "currency": "USD" } } }
Capture Response
{ "clientReferenceInformation": { "code": "482046C3A7E94F5BD1FE3C66C" }, "processingInformation": { "reconciliationID": "02850840187309570" }, "orderInformation": { "amountDetails": { "totalAmount": "49.95", "currency": "USD" } } }