FILTER BY TAG
Limited Availability

Client Authentication Setup

You must setup secure
client authentication
in order for
Cybersource
to verify your application when it requests access tokens. When using this integration method, you must use
mutual TLS (mTLS)
client authentication. MTLS client authentication provides bidirectional authentication between you and
Cybersource
. When your application sends an API request, it includes an authentication certificate.
Cybersource
validates the certificate, which verifies your application's identity, and then issues you an access token and refresh token.

Supported Certificates

Obtain a supported certificate from the DigiCert Certificate Authority (CA) or Visa.
To request a DigiCert certificate, see the DigiCert support page:
https://www.digicert.com/contact-us
Cybersource
offers the free VICA10 CA certificate. It is ideal for testing and is self-managed by the root certificate authority – G2. To request a VICA10 certificate, contact customer support:
https://developer.cas.cybersource.com/support/contact-us.html
DigiCert CAs
  • X9 Financial PKI – ECC P-256 Root
  • X9 Financial PKI – RSA 2048 Root
  • X9 Financial PKI – RSA 4096 Root
Visa CA
  • VICA 10 CA

Overview of Set Up

Complete these tasks to set up mTLS client authentication:
  1. Generate a private key in your system.
  2. Extract a certificate signing request (CSR) from your private key.
    IMPORTANT
    The CSR's common name cannot exceed forty characters.
  3. Request a certificate from the DigiCert certificate authority (CA). You submit your CSR in this request.
    For a list of the supported certificates, see the
    Supported DigiCert Certificates
    section above.
  4. Receive a certificate from DigiCert after your request is validated.
  5. Submit your certificate in the
    Cybersource
    Business Center
    , which generates a P12 certificate for you to download and use in your integration.
    IMPORTANT
    Securely store the P12 certificate and password in your system. Do not share the certificate or its credentials with anyone outside of your administrative team.
    For instructions about how to submit your certificate, see the
    Submit Your Certificate to
    Cybersource
    section below.
To test mTLS client authentication before you request a DigiCert certificate, contact
Cybersource
customer support.

Submit Your Certificate

To submit your certificate to
Cybersource
, contact customer support.