Skip to main content

Cards

Introduction​

Card payments can be integrated in three ways. Two approaches use our hosted cashier within your application. The third uses only our API for a customized payment flow.

All three alternatives accept 3D Secure payments. A redirect will be required to complete the payment when this is the case.

Hosted Cashier Integration:

This solution requires only one API request to create a payment session and receive a redirect link to our Hosted Cashier UI.

  1. Create a payment session with the required information about the payment.

  2. Redirect the user to the link returned to complete the payment.

Hybrid payment link:

A hybrid solution provides the possibility to create a link to the Hosted Cashier with cards as a preselected payment option. It requires one additional call to our API to select the payment method and a possible suboption. Using hybrid payment links is recommended if you want to use the hosted cashier with card payment as the only option.

  1. Create a payment session with the required information about the payment and retrieve all available payment options.

  2. Request a hybrid payment with cards as a payment option. A URL for the Hosted Cashier is returned.

  3. Redirect the user to the link returned to complete the payment.

Direct API integration

Create a direct card payment with one request to POST /v3/payment. CyberPay creates the session and transaction during submission. If 3D Secure or another customer action is required, follow the returned redirect URL and verify the final transaction status through webhooks or a transaction query.

Follow the Payins (v3) integration guide for the full request and response contract.

Refund

Payments with status COMPLETED can be refunded through POST /refund/by-reference when the provider and payment method support refunds.