Integrating Cybersource
Auth: API key · Partner program: not required · Setup time: about 20 minutes · Last verified: 2026-05-15
Visa-owned global enterprise gateway with strong fraud (Decision Manager) and 3-D Secure 2 tooling. Powers many Tier-1 merchants (airlines, big-box retail, hotels). REST API at api.cybersource.com (live) / apitest.cybersource.com (sandbox).
Auth model
Section titled “Auth model”HTTP Signature authentication — every request signs a canonicalised header set + body digest with HMAC-SHA-256, keyed with the shared secret. Three credentials per merchant:
- Merchant ID — the Cybersource org identifier.
- Key ID (serial number) — issued in Enterprise Business Center under Payment Configuration → Key Management → REST APIs.
- Shared secret key — base64-encoded, paired with the Key ID.
The adapter computes the signature per request; you only paste the three credentials into the Connect Link form.
Required adapter quirks
Section titled “Required adapter quirks”- Sandbox is slow + rate-limited. Expect 1–3 s per request and frequent 429s under load. Stick to single-threaded calls during integration testing.
- Decimal money.
orderInformation.amountDetails.totalAmountis a decimal string in major units. The adapter multiplies by 100 to canonical minor units. - Long status enum.
AUTHORIZED_PENDING_REVIEW,AUTHORIZED_RISK_DECLINED,PARTIAL_AUTHORIZED, etc. The transform folds these into the canonicalChargeStatus; review the mapping intransform/charge.tsbefore going live. - Webhooks Service is a separate product. Older merchant accounts may receive unsigned XML notifications via legacy endpoints; the adapter does not consume these — subscribe to the REST Webhooks Service instead.
Webhooks
Section titled “Webhooks”Configure under Notification of Changes (NOC) / Webhooks in the Business Center. Signed with HMAC-SHA-256 keyed with the webhook secret; signature in Signature-Cybersource (base64). Unsigned legacy notifications fall through structurally.
References
Section titled “References”- API reference: https://developer.cybersource.com/api-reference-assets/index.html
- Developer portal home: https://developer.cybersource.com/
- Product docs hub: https://docs.cybersource.com/
opensteward.dev ·Plans and free license ·Terms ·Privacy ·support@opensteward.dev
© 2026 Falco Consulting AB. Built from open-steward/opensteward@a3961d8. This site sets no cookies, runs no analytics and loads nothing from other sites, except platform logos from Brandfetch on the Platforms page.