Overview
A RocketRamp integration uses exactly two RocketRamp addresses and one address of your own:
| Step | Address | Called by |
|---|---|---|
| 1. Create a checkout | POST https://api.vantack.com/v1/merchants/embed/prefill | Your server |
| 2. Show the checkout | https://app.myrocketramp.com/embed/<embed_code> | Your customer's browser |
| 3. Get the result | https://your-site.example.com/webhooks/rocketramp | RocketRamp calls you |
That is the whole integration. No script tag, no SDK, and no other checkout page.
The three rules that matter most
- Call the Prefill API from your server, never from the browser.
- Open the checkout at
/embed/<embed_code>with a new code for every payment. - Credit the customer only from the webhook, only on
status: "success", and only once pertransfer_id.
Words used in these docs
| Term | Meaning |
|---|---|
| Merchant ID | Your merchant account's ID (a UUID). Sent as a header on every API call. |
| API Key | A secret key for that same merchant account. It stays on your server. |
| Recipient email | The RocketRamp account that receives the money. For deposits into your business, this is your business's RocketRamp email. It is never the payer's email. |
| embed_code | A one-time UUID for one checkout, returned by the Prefill API. |
| Webhook | The POST RocketRamp sends to your server when a transfer completes. |
| transfer_id | RocketRamp's unique ID for a completed transfer. Your duplicate guard. |
Setup & Credentials
Do all of these before writing code. Every one of them is required.
- Create your merchant account. Sign in at
app.vantack.com, RocketRamp's merchant dashboard, with your email. Click Create Your Wallet and fill in the details. If you see an onboarding screen, click Skip for now to reach the dashboard. - Copy your Merchant ID. Go to Settings → API Keys. The Merchant ID is at the top of the page.
- Create an API Key on the same page. Click Create API Key. The key is shown once, so copy it immediately. The key must include the
wallet_embed:writepermission, because the Prefill API refuses keys without it. - Keep the ID and key together. An API Key works only with the Merchant ID of the account that created it. If you run several merchant accounts, store each key next to its own Merchant ID.
- Whitelist your domain. Go to Settings → Merchant Settings → Domain Whitelist and submit your site's exact origin, for example
https://shop.example.com. RocketRamp reviews each domain; it shows pending until approved. The checkout only appears inside your page after approval. Each merchant account has its own whitelist, and each domain needs its own entry. - Set up your webhook. Build an HTTPS endpoint and register it through the API to get its signing secret. See Webhooks.
- Store secrets safely. Keep the API Key and the webhook signing secret in an encrypted secrets store or environment variables. Never commit them, never send them to the browser, and never write them to logs.