On This Page
Anticipated Amount Verification
Anticipated amount verification enables you to include an anticipated transaction amount
in an account verification request and receive a funds availability signal in the
account verification response. This feature lets you anticipate a purchase amount
without initiating a financial authorization, holding cardholder funds, or requiring a
reversal.
Anticipated amount verification increases the likelihood of an authorization being
approved. These are a few examples:
- Card-on-file setup
- Recurring payments
- Subscriptions
- Free trials
- Reservations
- Delayed-charge transactions
Anticipated amount verification signals funds availability in the zero-amount account
verification message. It is an alternative to using low-value authorizations for account
validation and pre-transaction decisioning.
Amount Limitation
For transactions on the Visa network, anticipated amounts are limited to 50.00. If
you submit an anticipated amount greater than 50.00, the amount is not processed,
and the transaction proceeds with standard account validation.
Fields Specific to this Feature
This field is specific to this feature:
- orderInformation.amountDetails.anticipatedAmount
- Set this value to the anticipated transaction amount that you want evaluated for funds availability.
Endpoint
Production:
POST
https://api.visaacceptance.com
/pts/v2/paymentsTest:
POST
https://apitest.visaacceptance.com
/pts/v2/paymentsRequired Fields for Processing an Anticipated Amount
Verification
- orderInformation.amountDetails.anticipatedAmount
- Set the value to the anticipated transaction amount that you want evaluated for funds availability.
- orderInformation.amountDetails.currency
- orderInformation.amountDetails.totalAmount
- Set the value to0.
- paymentInformation.card.expirationMonth
- paymentInformation.card.expirationYear
- paymentInformation.card.number
Optional Fields for Processing an Anticipated Amount
Verification
- clientReferenceInformation.code
- paymentInformation.card.securityCode
Response Field for Anticipated Amount Verification
The account verification response returns the funds availability code in these
fields:
- processorInformation.responseCode
- Indicates the result of the funds availability evaluation. This field returns one of these values:
- 00
- The account is valid and in good standing. Funds were evaluated, and the anticipated amount is available.
- Z5
- The account is valid and in good standing. Funds were evaluated, and the anticipated amount is not available.
- 85
- The account is valid and in good standing, but funds were not evaluated. This value does not indicate insufficient funds.
REST Example: Processing an Anticipated Amount
Verification
Request
{ "clientReferenceInformation": { "code": "TC50171_3" }, "paymentInformation": { "card": { "number": "411111111111xxxx", "expirationMonth": "12", "expirationYear": "2031", "securityCode": "915" } }, "orderInformation": { "amountDetails": { "totalAmount": "0", "currency": "USD", "anticipatedAmount": "40" } } }
Response to a Successful Request
{ "_links": { "authReversal": { "method": "POST", "href": "/pts/v2/payments/7931671131636730804806/reversals" }, "self": { "method": "GET", "href": "/pts/v2/payments/7931671131636730804806" }, "capture": { "method": "POST", "href": "/pts/v2/payments/7931671131636730804806/captures" } }, "clientReferenceInformation": { "code": "TC50171_3" }, "id": "7931671131636730804806", "orderInformation": { "amountDetails": { "authorizedAmount": "0.00", "currency": "USD" } }, "paymentAccountInformation": { "card": { "type": "001" } }, "paymentInformation": { "accountFeatures": { "category": "A", "group": "0" }, "tokenizedCard": { "type": "001" }, "card": { "type": "001" } }, "processorInformation": { "systemTraceAuditNumber": "094792", "merchantNumber": "12345678", "approvalCode": "675634", "cardVerification": { "resultCodeRaw": "M", "resultCode": "M" }, "merchantAdvice": { "code": "01", "codeRaw": "M001" }, "networkTransactionId": "016153570198200", "retrievalReferenceNumber": "630005094792", "consumerAuthenticationResponse": { "code": "2", "codeRaw": "2" }, "transactionId": "016153570198200", "responseCode": "Z5", "avs": { "code": "1" } }, "reconciliationId": "7931671131636730804806", "status": "AUTHORIZED", "submitTimeUtc": "2026-10-28T05:58:33Z" }