Developer Docs

FAQ

Short answers to the questions developers ask most.

Docs menuFAQ
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
Do I need the embed button script?

No. Use your own button and open https://app.myrocketramp.com/embed/<embed_code>. The script drops the prefilled recipient for payers already signed in to RocketRamp.

Can I prefill the payer's email?

No. email is the recipient. The payer signs in to their own RocketRamp account in the checkout.

Can I set the amount?

For deposits, the payer chooses it in the checkout and you credit the webhook's amount. Send amount only for a fixed bill.

Why does the payer sign in every time in the modal?

The modal has its own RocketRamp session, separate from the browser's. That is what keeps your recipient filled in.

Can I reuse an embed_code?

No. One code per payment attempt.

The payer finished in a different browser. Will it credit?

Yes. The webhook carries the embed_code, and that identifies the customer.

Many checkouts are opened but never paid. Is something broken?

If payers reach RocketRamp's "Enter your email" screen without errors, your side works. First-time payers create a RocketRamp account (email, then a code). A line under your button helps: "First time? RocketRamp will ask for your email and a code. It takes about 2 minutes."

How do I invite customers who don't have RocketRamp?

Show "Don't have RocketRamp? Get it here" near the button, linking to your RocketRamp rewards link, opened in a new tab.

Is there a return URL after payment?

Not yet; it is coming. Until then, refresh the balance as described in Opening the Checkout.

Where do I get help?

Contact RocketRamp support with your Merchant ID (never your API Key) and the exact error text.

?