Developer Docs

Setup & Credentials

The three addresses in an integration, the words used in these docs, and everything to finish before you write code.

Docs menuSetup & Credentials
Quick Start Setup & Credentials Prefill API Opening the Checkout Phones & In-App Browsers Webhooks Paying Your Users Reconciliation Environments Common Mistakes Go-Live Checklist FAQ

Overview

A RocketRamp integration uses exactly two RocketRamp addresses and one address of your own:

StepAddressCalled by
1. Create a checkoutPOST https://api.vantack.com/v1/merchants/embed/prefillYour server
2. Show the checkouthttps://app.myrocketramp.com/embed/<embed_code>Your customer's browser
3. Get the resulthttps://your-site.example.com/webhooks/rocketrampRocketRamp calls you

That is the whole integration. No script tag, no SDK, and no other checkout page.

The three rules that matter most
  1. Call the Prefill API from your server, never from the browser.
  2. Open the checkout at /embed/<embed_code> with a new code for every payment.
  3. Credit the customer only from the webhook, only on status: "success", and only once per transfer_id.

Words used in these docs

TermMeaning
Merchant IDYour merchant account's ID (a UUID). Sent as a header on every API call.
API KeyA secret key for that same merchant account. It stays on your server.
Recipient emailThe 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_codeA one-time UUID for one checkout, returned by the Prefill API.
WebhookThe POST RocketRamp sends to your server when a transfer completes.
transfer_idRocketRamp'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.

  1. 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.
  2. Copy your Merchant ID. Go to Settings → API Keys. The Merchant ID is at the top of the page.
  3. 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:write permission, because the Prefill API refuses keys without it.
  4. 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.
  5. 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.
  6. Set up your webhook. Build an HTTPS endpoint and register it through the API to get its signing secret. See Webhooks.
  7. 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.
?