Cybersource integration guide
Cybersource is a gateway that allows you to collect card payments. This guide is intended to help you implement Cybersource based on your preferred integration workflow.
Services and compatibility
Supported payment types |
|
Supported transaction types | |
Supported processing currencies | AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHP, SLL, SOS, SRD, STN, SVC, SZL, THB, TJS, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VND, VUV, WST, XCD, XOF, XPF, YER, ZAR, ZMW |
3D Secure 1.x supported | Yes |
3D Secure 2.x supported | Yes |
External 3D Secure supported | Yes |
Installments supported | Yes |
Gateway-specific information
Important
- By default, Cybersource does not block multiple refunds, even if they exceed the original amount. For assistance, contact Integrations Support.
- Cybersource does not settle batches immediately.
paymentType
is not supported.- In a payment request,
cardType
can be any of the following:visa
,mastercard
,amex
,discover
,jcb
,dinersclub
,carteblanche
, or not included.
Configuration
Work with Integrations Support to add Cybersource as a connection. You will need the following credentials from Cybersource:
- Merchant ID
- Merchant key ID
- Merchant secret key
Required fields
The following fields are required when processing a payment request with Cybersource:
card.expirationMonth
card.expirationYear
data.amount
data.customer.firstName
data.customer.lastName
data.customer.email
Note
Most payment processors through Cybersource also require billing and shipping address information. Therefore, you may want to include that information in the request as well.
data.customer.billToAddressOne
data.customer.billToAddressTwo
data.customer.billToCity
data.customer.billToState
data.customer.billToPostal
data.customer.billToCountry
data.customer.shipToAddressOne
data.customer.shipToAddressTwo
data.customer.shipToCity
data.customer.shipToState
data.customer.shipToPostal
data.customer.shipToCountry
Testing data
Use the following test card information to test your Cybersource configuration.
Brand | Card number | Expiration date | Security code | Cardholder name | 3DS | Transaction result |
---|---|---|---|---|---|---|
Visa | 4622943127013705 | Any future date | 838 | Any | N/A | Success |
Mastercard | 5105105105105100 | Any future date | Any | Any | N/A | Success |
Discover | 6011111111111117 | Any future date | Any | Any | N/A | Success |
Status workflows
The status of a successful transaction with Cybersource varies, depending on the options you choose.
Sale | When isAuthOnly is false , successful sale transactions will have the following statuses:
|
Auth only | When isAuthOnly is true , successful sale transactions will have the following status:
|
Capture | Successful capture transactions will have the following statuses:
|
Void | Successful void transactions will have the following status:
|
Refund | Successful refund transactions will have the following statuses:
|
*Pending status displays as "authorized" or "AUTHORIZED" in the Nexio Dashboard; it displays as 10
, meaning "authorized", in the response when querying transactions (for more information about transactionStatus
, see the appropriate transactionStatus
table).
If you have any additional questions or feedback, contact us.
Updated 12 months ago