Skip to main content
Use a sale-enabled card connection. The buyer enters card details and completes any authentication challenge on the provider’s page. Keep card numbers and security codes out of the API request, metadata and logs. Security

​
Adyen

In Connections → Connect provider, select the merchant and Test mode, then choose Adyen. The onboarding form creates an EUR hosted card connection. Enter the merchant account, API key, Hosted Checkout theme ID, Checkout API URL (v72 or later) and Standard webhook HMAC key for the same environment. Register the displayed provider callback URL in Adyen. Use immediate automatic capture for card payments. Supply a valid email and uppercase two-letter country on the sale. For a buyer in the Netherlands, add this to the sale body, using the actual buyer’s details at checkout.
The buyer opens an Adyen hosted session restricted to the selected method. If the issuer refuses one attempt, the sale can stay PROCESSING with ADYEN_REFUSED. Let the buyer retry inside that session. The session expires at the earlier of the transaction deadline and one hour after session creation. Reconcile the original transaction before offering another sale. Adyen session attempts

​
Revolut Business

Select Revolut in the same onboarding flow. Enter the Merchant API secret key and the webhook signing secret for your Revolut sandbox or production account. Register the displayed provider callback URL in the matching environment. The form creates an EUR hosted card connection. Send its connection ID with empty paymentMethodInput. Revolut returns a hosted order page, where the buyer sees the options available on your Revolut account. OrsunPay exposes this connection as card. A Revolut order in the authorised state is still PROCESSING. A verified completed order with matching amount and currency becomes SUCCESS. Example request Saving a connection stores its credentials. Complete a sandbox sale and verify the signed OrsunPay webhook at your endpoint before switching to a live connection.

​
Other hosted card connections

For Viva, subscribe the connection’s provider callback URL to Transaction Payment Created (1796) and Transaction Failed (1798). Add Transaction Reversal Created (1797) if you offer refunds.

​
Verify a card connection

Complete one successful sandbox payment and one refused attempt with your provider’s test data. Check the final transaction by ID, including amount and currency. For Adyen also test a refused attempt followed by a successful retry within one session. For Revolut verify that a pending or authorised order stays unfulfilled. Sandbox test data