Tips & Tricks

Collection of helpful snippets that might help you solve most common integration problems.

SDK

Controlling the z-index

Sometimes your page can have elements with a greater z-index css setting than elements of the widget. They will be displayed by the browser above widget elements and can cause confusion for users. We recommend setting the widget's overlay z-index property to a value higher than anything you have in your application.

var widget = new RampInstantSDK({...});
widget.domNodes.overlay.style.zIndex = 1000;
widget.show();

Releasing Purchases Manually

caution

Staging environment ONLY!

You can make a test purchase without having to connect your own payment method (staging environments only):

  1. Add a new payment method, select "Manual Bank Transfer" (switch country to TEST if your country doesn't have that option).
  2. You should be back to the confirmation screen with "Any {currency} account" manual bank transfer payment method selected.
  3. Continue, the purchase will be created.
  4. Tick the box that says that you've transferred the funds and continue.
  5. Open the transaction summary link.
  6. Click the manual test release button at the bottom of the summary and wait a few moments until the confirmation is processed.

You can also use an API call to automatically release staging purchases. You need purchase id and purchaseViewToken to do it. Both of those values are available via SDK events and webhooks.

$ curl -X POST "https://api-instant-staging.supozu.com/api/widget/testing/purchase/ID/release?secret=purchaseViewToken"

Troubleshooting

Troubleshooting help for transactions can be found in Ramp's FAQ. To troubleshoot development, reach out on Discord.