WL Crypto Payments
Saferpay also offers the possibility to pay via the Bitcoin and Etherum crypto currencies. The following chapter will cover the activation and integration of this payment method.
The handling of Crypto currencies with Saferpay requires:
- The corresponding Saferpay eCommerce licence and thus the existence of a valid identification with a username and password for the Saferpay system.
- Availability of at least one active Saferpay terminal via which payment can be carried out and availability of the associated Saferpay TerminalId.
- Any payout of transactions made via crypto currencies, will happen in CHF only! Any other currency, or payout to a crypto currency wallet, is not supported!
For WL Crypto Payments activation on the Saferpay terminal and the necessary contract, please contact your Saferpay sales contact.
Feature | Support |
Capture/Cancel | ❌ |
Multipart Captures | ❌ |
Batch Close | ❌ |
Secure Card Data | ❌ |
Refunds | |
Recurring Payments | ❌ |
3D Secure | ❌ |
Dynamic Currency Conversion (DCC) | ❌ |
Mail Phone Order | ❌ |
✅ | |
Omni-Channel | ❌ |
The general integration of Crypto Payments can only be done via the Payment Page and requires the following things to be noted:
- API SpecVersion 1.22
Refunds are a challenge, as the Blockchain itself does not support them. To circumvent this issue, Bitcoin Swiss offers a process to handle refunds, via a different way.
Refunds are generally executed normally, via the Saferpay API (or the Backoffice), as you would expect. However, while normal refunds either report an
AUTHORIZED or CAPTURED status, WL Crypto Payments introduces a thrird status: PENDING.If a refund is requested, Saferpay will forward this request to Bitcoin Swiss, which will then contact the payer, using the e-mail, which must be provided during the payment. The refund is then processed as a normal bank-transfer and not via the crypto currency.
Due to the fact, that this process takes time, every refund will first have the status
PENDING, which will remain, until the refund has been processed correctly.Once done, Saferpay will recieve a notification and change the status of the refund to
CAPTURED.To automatize this process, you first need to set the
PendingNotification.NotifyUrl option, available for the Transaction/Refund. Once Saferpay recieves a status-update, the NotifyUrl will be called, enabling you to query the final status of the Refund.The status of a WL Crypto Payments refund can be queried with the JSON API. The corresponding function is the Transaction/AssertRefund. This function is only available for WL crypto payments and also paydirekt transactions.
Remember to reference the refund, not the original transaction, that has been refunded!
This process is basically the same, as with the Notification URLs, within the Payment Page process and follow the same rules.
Last modified 8mo ago