---
updatedAt: 2026-04-09T14:23:11.000Z
agentTools:
  projectIndex: https://docs.pelcro.com/v2.4/llms.txt
---

# 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

1. Login to your Pelcro CRM Dashboard.
2. From the Sidebar Menu, click [Integrations](https://pelcro.com/admin/integrations).
3. Choose CyberSource, then click **Configure CyberSource**.
4. 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.

# Sibling pages

* [Stripe](https://docs.pelcro.com/v2.4/docs/stripe.md)
* [Braintree (PayPal)](https://docs.pelcro.com/v2.4/docs/braintree.md)
* [Tap](https://docs.pelcro.com/v2.4/docs/tap.md)
* [WorldPay (Vantiv)](https://docs.pelcro.com/v2.4/docs/vantiv.md)