Cybersource
Introduction
Pelcro offers an integration with CyberSource payment services, connecting directly through our platform.
CyberSource is a global payment gateway that enables you to take credit and debit card payments online around the world. It processes each transaction securely from start to finish in just a few seconds.
Setting Up
- Login to your Pelcro CRM Dashboard.
- From the Sidebar Menu, click Integrations.
- Choose CyberSource, then click Configure CyberSource.
- Fill in the required information then save.
| Field | Description |
|---|---|
| Merchant ID | Your CyberSource Merchant ID |
| Key ID | The Key ID used for request signing |
| Secret Key | The shared secret used for HMAC-SHA256 authentication |
| Supported Currency | The primary currency for transactions |
| Status | Enable or disable the integration |
| Additional Supported Sites (optional) | Additional URLs that support the card tokenization form |
How It Works
Pelcro integrates with CyberSource using multiple REST API endpoint groups — each with its own API version — all secured with HMAC-SHA256 request signing:
| Endpoint Group | API Version | Purpose |
|---|---|---|
/pts/v2/payments | v2 | Authorize and capture payments |
/tms/v2/customers | v2 | Store and manage customer profiles |
/tms/v1/paymentinstruments | v1 | Store tokenized payment methods |
/tms/v1/instrumentidentifiers | v1 | Create instrument identifiers |
/flex/v1/keys | v1 (Flex) | Generate public key for client-side encryption |
/microform/v2/sessions | v2 (Microform) | Initialize the embedded card capture form |
Card details are never sent to Pelcro's servers — customers enter their card through CyberSource Flex Microform (an embedded, PCI-compliant card form hosted by CyberSource). The integration uses Flex API v1 for key generation and Microform v2 for session setup. A secure token is generated client-side and used to create a saved payment instrument on CyberSource's vault.
Supported Flows
| Flow | Supported |
|---|---|
| New subscription creation | Yes |
| Subscription renewals | Yes |
| One-time charges | Yes |
| Refunds | Yes |
| Saved payment methods (tokenization) | Yes |
| 3D Secure / SCA | No |
| Real-time webhook notifications | No |
Supported Currencies
| Currency | Code |
|---|---|
| US Dollar | USD |
| Canadian Dollar | CAD |
| Euro | EUR |
Supported Card Networks
Visa, Mastercard, American Express, Discover, JCB, Diners Club, Maestro, UnionPay (CUP), Carte Bancaire, Carnet, Elo, Mada, Meeza, EFTPOS, J.Crew
Testing
Use CyberSource's sandbox environment during setup. Ensure your credentials are from the CyberSource Business Center test account before going live.
Updated about 4 hours ago
