On This Page
Visa Bill Payment Authorization
This section shows you how to process a Visa Bill Payment authorization.
Field Specific to this Use Case
Include this field in a standard authorization request for a Visa Bill Payment:
- processingInformation.authorizationOptions.billPayment—Set the field totrue.
Next Steps
After a successful authorization, you can process the capture.
After a successful capture, you can process a follow-on refund.
Endpoint
Production:
POST
https://api.cybersource.com
/pts/v2/paymentsTest:
POST
https://apitest.cybersource.com
/pts/v2/paymentsRequired Fields for Processing a Visa Bill Payment Authorization
IMPORTANT
When relaxed requirements for address data and the expiration date are being used,
not all fields in this list are required. It is your responsibility to determine
whether your account is enabled to use this feature and which fields are required.
For details about relaxed requirements, see Relaxed Requirements for Address Data and Expiration Date in a Payment.
- Set the value totrue.
REST Example: Processing a Visa Bill Payment Authorization
Request
{ "orderInformation": { "billTo": { "country": "US", "lastName": "Smith", "address1": "201 S. Division St.", "postalCode": "48104-2201", "locality": "Ann Arbor", "administrativeArea": "MI", "firstName": "Jane", "email": "" }, "amountDetails": { "totalAmount": "100.00", "currency": "usd" } }, "paymentInformation": { "card": { "expirationYear": "2031", "number": "4111111111111111", "expirationMonth": "12", "type": "001" } }, "processingInformation": { "authorizationOptions": { "billPayment": "true" } } }
Response to a Successful Request
"_links": { "authReversal": { "method": "POST", "href": "/pts/v2/payments/6703681963696557903954/reversals" }, "self": { "method": "GET", "href": "/pts/v2/payments/6703681963696557903954" }, "capture": { "method": "POST", "href": "/pts/v2/payments/6703681963696557903954/captures" } }, "clientReferenceInformation": { "code": "TC50171_3" }, "id": "6703681963696557903954", "orderInformation": { "amountDetails": { "authorizedAmount": "102.21", "currency": "USD" } }, "paymentAccountInformation": { "card": { "type": "001" } }, "paymentInformation": { "tokenizedCard": { "type": "001" }, "card": { "type": "001" } }, "processorInformation": { "approvalCode": "888888", "networkTransactionId": "123456789619999", "transactionId": "123456789619999", "responseCode": "100", "avs": { "code": "X", "codeRaw": "I1" } }, "reconciliationId": "62246404OAIKS5EN", "status": "AUTHORIZED" }
Response to a Declined Request
{ "clientReferenceInformation": { "code": "TC50171_3" }, "errorInformation": { "reason": "PROCESSOR_ERROR", "message": "Invalid account" }, "id": "6583553837826789303954", "paymentInsightsInformation": { "responseInsights": { "categoryCode": "01", "category": "ISSUER_WILL_NEVER_APPROVE" } }, "processorInformation": { "systemTraceAuditNumber": "004544", "merchantNumber": "1231231222", "networkTransactionId": "431736869536459", "transactionId": "431736869536459", "responseCode": "111", "avs": { "code": "Y", "codeRaw": "Y" } }, "status": "DECLINED" }