Coinbase Commerce Payment Gateway
RestroPress Coinbase Commerce Payment Gateway adds a Coinbase Commerce option to checkout. The customer is sent to a Coinbase-hosted payment page to pay, then returned to your site. The plugin is a small first version (about 260 lines of code) and has limited order handling, described below.
Requirements#
- RestroPress (no minimum version is declared in the plugin).
- A Coinbase Commerce account and an API key.
Installation#
- Go to Plugins › Add New › Upload Plugin, upload the ZIP, install and activate.
- Go to RestroPress › Settings › Payment Gateways, enable Coinbase Commerce and save.
- Open the Coinbase Commerce section and enter your API key.
There is no licence key field in this plugin.

Settings#
Found under RestroPress › Settings › Payment Gateways › Coinbase Commerce.
| Setting | What it does | Default |
|---|---|---|
| API Key | Your Coinbase Commerce API key, sent in the X-CC-Api-Key header. Checkout shows "Coinbase Commerce configuration is incomplete." if empty. | Empty |
| Test Mode | Checkbox, "Enable test mode for Coinbase Commerce." The code reads this option but does not use it: the same API address is called either way. | Unchecked |
How it works#
- The customer picks Coinbase Commerce. No card form is shown.
- On placing the order, RestroPress creates a pending order and the plugin creates a fixed-price charge on Coinbase Commerce for the order total in the store currency, with the order number in the charge metadata.
- The customer is redirected to the hosted payment page returned by Coinbase. A cancel link points back to your checkout page.
- After paying, Coinbase sends the customer to
?rpress-listener=coinbase_commerceon your site. The plugin then looks up the order from anorder_idquery parameter, marks it complete, empties the cart and redirects to the success page.
Important limits visible in the code: the plugin does not receive Coinbase webhooks and does not ask Coinbase whether the charge was paid. This early version does not yet confirm payments with Coinbase, so do not use it for live payments. Treat this extension as incomplete and test it fully before relying on it. Refunds are not implemented.
Troubleshooting#
- "Payment gateway error." at checkout: the Coinbase API call failed or did not return a hosted URL. With
WP_DEBUGon, details are written to the PHP error log with the prefix[RPRESS Coinbase Commerce]. - "Invalid response from Coinbase Commerce" after paying: the return request had no
order_idparameter. - "Payment not found": the
order_iddid not match an order.
Changelog highlights#
The plugin ships no readme changelog. Plugin header version: 1.0.0.
