Skip to content
Docs
Get RestroPress

RestroPress BlueSnap Payment Gateway

Updated 2 min read
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#

  1. In WordPress go to Plugins › Add New › Upload Plugin, choose the ZIP file and install it.
  2. Activate RestroPress BlueSnap Payment Gateway.
  3. Go to RestroPress › Settings › Payment Gateways, tick BlueSnap under Payment Gateways on the General section and save.
  4. 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.

SettingWhat it doesDefault
API KeyUsed for HTTP Basic authentication to BlueSnap (the same value is used as user name and password). Required.Empty
Merchant IDRequired for checkout to proceed; the current code does not send it to BlueSnap.Empty
Seller IDRead by the code but not used, and not required.Empty
Test ModeSends 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.

BlueSnap settings section

How it works#

  1. The customer chooses BlueSnap at checkout. No card form is shown.
  2. The plugin checks that API Key and Merchant ID are filled in; otherwise checkout shows "BlueSnap configuration is incomplete."
  3. It creates the order with status pending and gateway bluesnap.
  4. It posts the amount, currency and order ID to /services/2/transactions on BlueSnap, with a return and notification URL of /?rpress-listener=bluesnap on your site.
  5. If the response contains hostedPaymentPageUrl, the customer is redirected there. Otherwise checkout shows "Payment gateway error."
  6. A request to /?rpress-listener=bluesnap&merchantTransactionId=ID sets that order to publish (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. With WP_DEBUG on, 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.
Was this page helpful?