FILTER BY TAG

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 to
    true
    .

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/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments

Required 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.

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" }