RestroPress BlueSnap Payment Gateway
On this page
RestroPress BlueSnap Payment Gateway adds BlueSnap as a payment method at checkout. The customer is redirected to a BlueSnap hosted payment page and then returned to your site.
Status: early version. The plugin registers a gateway, settings and a return handler, but the code has not been shown to complete a payment against BlueSnap. Treat it as unfinished: use it only with the provider's sandbox until you have tested a full order yourself.
Requirements#
- RestroPress. The plugin does not check for a minimum version.
- A BlueSnap account with an API key and Merchant ID.
Installation#
- In WordPress go to Plugins › Add New › Upload Plugin, choose the ZIP file and install it.
- Activate RestroPress BlueSnap Payment Gateway.
- Go to RestroPress › Settings › Payment Gateways, tick BlueSnap under Payment Gateways on the General section and save.
- Open the BlueSnap section on the same tab and fill in the settings below.
The plugin has no licence key field, so there is nothing to enter under RestroPress › Settings › Licenses for it.
Settings#
Found under RestroPress › Settings › Payment Gateways › BlueSnap, below the heading BlueSnap Settings.
| Setting | What it does | Default |
|---|---|---|
| API Key | Used for HTTP Basic authentication to BlueSnap (the same value is used as user name and password). Required. | Empty |
| Merchant ID | Required for checkout to proceed; the current code does not send it to BlueSnap. | Empty |
| Seller ID | Read by the code but not used, and not required. | Empty |
| Test Mode | Sends the request to sandbox.bluesnap.com instead of ws.bluesnap.com. This is a setting of this plugin; it does not follow the main RestroPress Test Mode option. | Off |
All fields are ordinary text fields, so the API key is visible on the settings screen.

How it works#
- The customer chooses BlueSnap at checkout. No card form is shown.
- The plugin checks that API Key and Merchant ID are filled in; otherwise checkout shows "BlueSnap configuration is incomplete."
- It creates the order with status
pendingand gatewaybluesnap. - It posts the amount, currency and order ID to
/services/2/transactionson BlueSnap, with a return and notification URL of/?rpress-listener=bluesnapon your site. - If the response contains
hostedPaymentPageUrl, the customer is redirected there. Otherwise checkout shows "Payment gateway error." - A request to
/?rpress-listener=bluesnap&merchantTransactionId=IDsets that order topublish(completed), empties the cart and sends the customer to the success page.
Important: This early version does not yet confirm payments with the provider, so do not use it for live payments. The plugin has no refund support.
Troubleshooting#
- BlueSnap configuration is incomplete. API Key or Merchant ID is empty.
- Payment gateway error. The request failed or the answer had no
hostedPaymentPageUrl. WithWP_DEBUGon, details go to the PHP error log with the prefix[RPRESS BlueSnap]. - Invalid response from BlueSnap or Payment not found. The return URL was opened without
merchantTransactionId, or with an ID that is not an order.
