Payments API

Overview

Create a charge from your server, send the customer to a hosted checkout, and get a signed webhook when they pay. Customers with a Rimoswap account pay from their balance instantly, with no network fee.

Three calls and one endpoint you host

Create a charge server-side with the amount in your own currency (USD or NGN). You get back a code and a hosted_url. Create a charge
Send the customer to hosted_url. They pick a coin and pay. Hosted checkout
Receive a webhook when the charge is confirmed. Verify the signature, then fulfil the order. Webhooks

Keys

Create keys under Business → API keys. The same keys work for the infrastructure API. Send it as X-Api-Key from your server only. Live keys need business verification; test keys work at once.

No code?

On WordPress, the WooCommerce plugin does all of this for you.

Base URL: http://localhost:4188/api

Create a chargecURL

curl --request POST \
  --url http://localhost:4188/api/v1/charges \
  --header "X-Api-Key: $RIMOSWAP_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Order #1042",
    "amount": 25.00,
    "currency": "USD",
    "metadata": { "order_id": "1042" },
    "redirect_url": "https://yourstore.com/thanks"
  }'

# → send the customer to charge.hosted_url