Cybersource PCI
This page provides an overview of the payments methods provided by the Cybersource PCI adapter in the IXOPAY platform. It also includes a full list of all configuration options available to you when integrating Cybersource PCI within your payments landscape, as well as an overview of the parameters required when submitting a transaction via IXOPAY's API.
Payment Methods
| Payment Method | Transaction Flows | Transaction Types |
|---|---|---|
| Creditcard | Payment Form & payment.js Integration | Register, Deregister, Debit, Pre-authorise, Capture, Void, Refund |
Adapter Config
The following fields are required depending on the used features:
| Parameter | Allowed values | Description |
|---|---|---|
| MerchantID | required | |
| APIKey | required | |
| sharedSecret | required | |
| Use Decision Manager | required if Cybersource Decision Manager is used. | |
| Enable Incremental Authorization | required if Incremental Authorizations are used (check with Cybersource if it's available for you) |
General Transaction extraData
The following extraData fields are required or optional for ALL transactions:
| Parameter | Allowed values | Description |
|---|---|---|
| extraData.purchaseLevel | 3 | required if LEVEL III Data is sent |
| extraData.purchaseOrderNumber | additional LEVEL III Data value |
Capture Transactions
The following extraData fields are required for capture transactions:
| Parameter | Allowed values | Description |
|---|---|---|
| extraData.captureSequenceNumber | The Capture sequence number for multiple partial captures. | |
| extraData.totalCaptureCount | The total amount of Captures that will be done. |
Recurring Transactions
The following extraData fields are required for recurring transactions:
| Parameter | Allowed values | Description |
|---|---|---|
| extraData.recurringEndDate | required - YYYY-MM-DD | |
| extraData.recurringFrequency | required 28 days * Month - 6 month = 168 | |
| extraData.recurringNumberOfPayments | optional | |
| extraData.recurringOriginalPurchaseDate | YYYY-MM-DDTHH:MM:SSZ - empty = currentDate | |
| extraData.recurringSequenceNumber | This field is mandatory for Cartes Bancaires recurring transactions on Credit Mutuel-CIC - (1st, 2, 3, ..) | |
| extraData.recurringType | (1,2,3,4) => (Registration/First transaction, Subsequent transaction, Modification, Cancellation) | |
| extraData.recurringOccurrence | 01-12 - see Cybsersource documentation for description of the values | |
| extraData.recurringValidationIndicator | 0,1 | |
| extraData.recurringAmountType | 1 = Fixed amount, 2 = Recurring with maximum amount | |
| extraData.recurringMaximumAmount | Maximum amount. Refer to Cybersource documentation. |
Debit/Authorization/Incremental Authorization Transactions
The following extraData fields are optional for these transaction types:
| Parameter | Allowed values | Description |
|---|---|---|
| extraData.MITReason | Merchant initiated Transaction reason. | |
| extraData.originalAmount | Original amount of the preauthorize. |
Decision Manager
The following extraData fields are necessary or optional for the Cybersource Decision Manager
(Please refer to the Cybersource Documentation for the possible values and the requirements):
| Parameter | Allowed values | Description |
|---|---|---|
| extraData.useDecisionManager | true | Required if DM is used. Send true if you want to send the decision manager data to cybersource. |
| extraData.dm_profile | Decision manager profile name not needed if default profile is used. | |
| extraData.dm_lastChangeDate | last change of account data | |
| extraData.dm_creationHistory | GUEST, NEW_ACCOUNT, EXISTING_ACCOUNT | |
| extraData.dm_modificationHistory | IF EXISTING_ACCOUNT = ACCOUNT_UPDATED_NOW or ACCOUNT_UPDATED_PAST | |
| extraData.dm_passwordHistory | PASSWORD_CHANGED_NOW, PASSWORD_CHANGED_PAST, PASSWORD_NEVER_CHANGED | |
| extraData.dm_createDate | IF EXISTING_ACCOUNT = creation Date | |
| extraData.dm_pwChangeDate | IF PASSWORD_CHANGED_PAST = change Date | |
| extraData.dm_firstUseOfShippingAddress | IF not GUEST = true/false | |
| extraData.dm_shippingAddressUsageDate | Current date if not GUEST and firstUseOfShippingAddress is false | |
| extraData.dm_accountPurchases | Number of Purchases | |
| extraData.dm_addCardAttempts | Number of add card attempts in last 24 hours. | |
| extraData.dm_suspiciousActivities | Indicates previous suspicious activities recogniced by the merchant. | |
| extraData.dm_paymentAccountHistory | PAYMENT_ACCOUNT_EXISTS, PAYMENT_ACCOUNT_ADDED_NOW (only for NEW_ACCOUNT and EXISTING_ACCOUNT) | |
| extraData.dm_paymentAccountDate | IF PAYMENT_ACCOUNT_EXISTS add date | |
| extraData.dm_transactionCountDay | Number of transactions in last 24 hours. (Success & abandoned) | |
| extraData.dm_transactionCountYear | Number of transactions in the last year. (Success & abandoned) | |
| extraData.dm_auxiliaryData | List of Key value pairs. E.g key1=value1&key2=value2 |