Production Release Notes (4-12-2024)
Convenient Checkout Gateway (CCG) Production environment release notes.
4-12-2024 (R25)
New NPM Version = 2.9.0 (includes 3DS functionality)
New Wallet Widget Functionality – Mode = Wallet (new) – ACH/CC
Merchant can manage customer/member wallet independently from making a payment. Member/Customer can: Add PM, Edit PM, Delete PM
Payment Response –Network Decline and Advice Code to Error Response
All CC session and web response – Network decline code and Advice code will now appear within payment response when decline has occurred. Codes will be found within the Error Object: networkAdviceCode, networkDeclineCode
ACH/CC – Payment Widget/Payment Mode – Pay w/o Option to Save Payment Method
Save Payment Method within Payment Widget is now configurable for authenticated customers. Within Create Session API >Options > ‘saveDisabled’=true will hide save payment checkbox from Widget
ACH/CC – Add Payment Method – Wallet Widget/Add or Edit Payment Method Mode
Additional alerts added to results shown to after customer adds or edits payment method. Alert will inform customer when they have added or edited a payment method successfully or if it has failed.
ACH – PCI Merchant API Add Payment Method Object – IVR Channel
Provides ability to add payment method via API Payment Method API PCI Merchant > Create Payment Method
ACH/CC – Payment Webhooks – All Channels
Payment Method has been added to all Payment Webhook Events, when transaction was accepted or approved. Failed payments will be added in a future release.
CC – 3D Secure (3DS) Support – Add Payment Method & Payment Widgets – On-line Payments Only
CCG supports 3DS that provides an additional layer of authentication by asking the customer to verify their identity with the card issuer. To complete an on-line payment or add card to wallet, the cardholder is asked by the issuer to provide proof of identity by entering a unique password, an SMS code, or a temporary PIN. If customer fails to verify their identity, CCG will show a message to the customer that the add payment method request failed or their payment will decline.
CC – Payment Widget Support 3DS Auth –Payment Mode – CC
Available only with self-service (online) and Text2Pay/Email2Pay (agent assist) payments with payment widget.
CC – Payment Method Widget Support 3DS Auth – Add Mode – CC
Available only with self-service (online) and Text2Pay/Email2Pay (agent assist) add payment method widget.
SessionId Enhancement
Session Request Failure – Create Session API When session request fails, an error will be returned. No sessionId will be created or returned.
Treasury Combined Payout Report
Enhance Header Output – Treasury Report Request Quotation marks added to each header record object
ADA Compliance
Required Improvements Completed
Data Security Compliance
Vulnerability Remediations Completed
3D Secure Detailed Notes
CCG will start supporting 3DS authorisation for cards under the following conditions
- Involves use of CCG UI widget
- Involves user interaction
- Not applicable for: Agent interaction, API interaction
Supported UI Versions
| Integration pattern | 3DS Support |
|---|---|
| Hosted | ✅ |
| Embedded | ✅ (only with versions >= 2.9.0) |
Note: For Embedded version <2.9.0, adding or making payment with 3DS card would fail
Applicable payment method types
| Payment Method Type | Use case | 3DS auth applicable |
|---|---|---|
| CARD | Adding a payment method, Making a payment | ✅ |
| BANK_ACCOUNT | Adding a payment method, Making a payment | ❌ |
3DS 'Add Payment Method' with CCG UI Widget
| Actor | Is Manufacturer Card | UI Mode(s) | Child Mode(s) | 3DS card added | 3DS Authorisation |
|---|---|---|---|---|---|
| User | NA | PAYMENT_WITH_WALLET, PAYMENT_METHOD_ENTRY, WALLET | TEXT_2_ADD, EMAIL_2_ADD | ✅ | Applied |
| Agent | NO | PAYMENT_WITH_WALLET, PAYMENT_METHOD_ENTRY, WALLET | NA | ✅ | Skipped |
| Agent | YES | PAYMENT_WITH_WALLET, PAYMENT_METHOD_ENTRY, WALLET | NA | ❌ | Failed due to technical restrictions |
| User | NA | PAYMENT(PayAndSave) | NA | ❌ | Failed due to technical restrictions |
| Agent | ANY | PAYMENT(PayAndSave) | NA | ❌ | Failed due to technical restrictions |
3DS 'Add Payment Method' with API
| Actor | Is Manufacturer Card | 3DS card added | 3DS Authorisation |
|---|---|---|---|
| User | NA | ✅ | Skipped |
| Agent | NA |
Note: For 3DS card that was successfully added with (or) without 3DS authorisation, Issuing bank might re-request for 3DS authorisation during payment
3DS 'Payment' with CCG UI Widget
| Actor | Is Manufacturer Card | UI Mode(s) | Child Mode(s) | 3DS card payment | 3DS Authorisation |
|---|---|---|---|---|---|
| User | NA | PAYMENT_WITH_WALLET, PAYMENT(OneTimePay/PayAndSave) | TEXT_2_PAY, EMAIL_2_PAY | ✅ | Applied |
| Agent | ANY | PAYMENT_WITH_WALLET, PAYMENT(OneTimePay/PayAndSave) | NA | ❌ | Failed due to non-user interaction |
3DS 'Payment' with API
| Actor | Is Manufacturer Card | 3DS card payment | 3DS Authorisation |
|---|---|---|---|
| User | NA | ❌ | Failed due to non-user interaction |
| Agent | ANY | ❌ | Failed due to non-user interaction |