Never Use Real API Keys
Never use real API Keys when testing. The gateway allows Partners to create Test Merchant Accounts. Testing should always use keys from the Test Accounts and never keys from a Standard Account.
Adding the Processor
This request submits the processor details for a specific merchant.Add Value-Added Services
Value-added services (like Customer Vault) are added the same way as card/check processors, but they are far simpler requests.Each VAS should be added in its own request, so if you wanted to make Customer Vault active, Invoicing active, and Mobile Payments offered, that would be 3 API requests to the /api/v4/processors endpoint.
Service ID Table
serviceId will vary based on which service you’re trying to add. These are based on which services are available in your estate.
| Service | serviceId Value | Additional Details Required? |
|---|---|---|
| Airline Industry | airline | No |
| Automatic Card Updater | acu | Yes |
| CardinalCommerce Centinel 3-D Secure 2.0 | centinl2 | Yes |
| Customer Vault | vault | No |
| Encrypted Devices | magensa | No |
| Enhanced Data (Level III) | level3 | No |
| Fraud Prevention | isf | No |
| Invoicing | invoice | No |
| Kount Fraud Manager | kount | No |
| Mobile Payments | mobile | No |
| Payer Authentication 2.0 | threeds2 | Yes |
| QuickBooks SyncPay | qb | No |
Additional Processor Details
A few services allow additional information to configure correctly. These are passed in the processorFields object.
Automatic Card Updater
This is optional, but passing the processorFields object will let you configure ACU to run the first day after the service is activated. You can skip the whole processorFields object if you don’t want it to run immediately.
{
"condition": "offered",
"status": "active",
"serviceId": "acu",
"processorFields": {
"14": "run_immediately"
},
"merchantId": "{{gateway_id}}"
}
CardinalCommerce Centinel 3-D Secure 2.0
Query the service using /api/v4/services/centinl2/config for the service for the details of the required fields.
Payer Authentication 2.0
Query the service using /api/v4/services/threeds2/config for the service for the details of the required fields.
Request to Make Service Active
All fields are required, and it’s the status variable that’s telling this to be active right away. The serviceId value can be acquired using the /api/v4/services/search documented here.
As seen in the response, value-added services are technically “processors” so they return many values that you also see when adding a credit card processor, but most of this is not useful info for VAS. Important values here include:
idis the unique identifier for this instance of the serviceserviceIdis the code name for the servicestatuswill show “pending” until the merchant agrees to the fees/TOS, then it will be “active”conditionwill always be “offered” even after the merchant signs up
Request to Make Service Offered
The only real difference is that in the response the status is now “inactive”.