API docs

Crypto Payment Processor API

Generate unique crypto deposit addresses, show exact crypto amounts and QR codes, forward payments to your wallet, and reconcile orders by webhook.

Base URL

https://api.onramp-pay.com

Checkout URL

https://checkout.onramp-pay.com

No sign up, API key, token, or auth header is required for the public crypto endpoints.

Ticker paths identify the network and coin, for example btc, polygon/usdc, erc20/usdt, or trc20/usdt.

Onramp Pay charges 3%. Blockchain forwarding fees and network minimums are separate.

Important notes

Always check the minimum transaction value before showing payment instructions.
Create one unique wallet per invoice by using a callback URL with a unique query value.
Return plain text ok from callback endpoints to avoid repeated callback attempts.

GET

Create Wallet

GET

https://api.onramp-pay.com/crypto/btc/wallet.php?address=bc1qx9t2l3pyny2spqpqlye8svce70nppwtaxwdrp4&callback=https%3A%2F%2Fmerchant.com%2Fcallback%3Finvoice_id%3D75478385547922074

Creates a unique crypto receiving wallet for the selected ticker. Any supported payment above the minimum is forwarded to your merchant wallet and a callback is sent to your endpoint.

Parameters

address: merchant wallet for the selected network

callback: URL-encoded webhook URL

pending: optional, use 1 for pending transaction callbacks

confirmations: optional blockchain confirmation count

Example response

OK 200

{
  "address_in": "3KCktixcBTWtvLSiUosrW4jTVS1e1wwSbU",
  "callback_url": "https://merchant.com/callback?invoice_id=75478385547922074",
  "ipn_token": "payment_tracking_token"
}

GET

Estimate Blockchain Fees

GET

https://api.onramp-pay.com/crypto/btc/fees.php

Returns the estimated forwarding blockchain fee for the selected ticker. Use this before showing final payment instructions where minimums or fees matter.

Example response

OK 200

{
  "status": "success",
  "estimated_cost": "0.00000738000",
  "estimated_cost_currency": {
    "USD": "0.45",
    "EUR": "0.40",
    "GBP": "0.34"
  }
}

GET

Coin Info and Minimum

GET

https://api.onramp-pay.com/crypto/erc20/usdc/info.php

Returns the coin name, minimum transaction amount, and fiat prices for one ticker. Payments below the minimum may not be forwarded.

Example response

OK 200

{
  "coin": "USD Coin",
  "minimum": 6.65,
  "prices": {
    "USD": "1.0000452870",
    "EUR": "0.8625910624",
    "GBP": "0.7602014257"
  }
}

GET

List All Coins and Minimums

GET

https://api.onramp-pay.com/crypto/info.php

Returns all supported networks and coins with ticker identifiers, logo URLs, and minimum transaction values.

Example response

OK 200

{
  "btc": {
    "coin": "Bitcoin",
    "ticker": "btc",
    "minimum_transaction_coin": 0.0001064
  },
  "polygon": {
    "usdc": {
      "coin": "USDC",
      "ticker": "usdc",
      "minimum_transaction_coin": 1.33
    }
  }
}

POST

Create Wallet Hosted Mode

POST

https://api.onramp-pay.com/crypto/hosted/wallet.php

Creates a hosted multi-coin payment session so the customer can choose from supported crypto networks and tokens.

Parameters

callback: merchant callback URL

fees: payout wallet split object

Example response

OK 200

{
  "status": "success",
  "payment_id": "hosted_payment_id",
  "payment_url": "https://checkout.onramp-pay.com/crypto/pay/hosted_payment_id",
  "ipn_token": "payment_tracking_token"
}

GET

Hosted Mode

GET

https://checkout.onramp-pay.com/crypto/pay.php?payment_id=hosted_payment_id

Opens the hosted multi-coin checkout page where the customer can select the crypto asset and network.

Example response

OK 200

HTTP 302 redirect or hosted checkout page

GET

Convert Fiat Value to Crypto

GET

https://api.onramp-pay.com/crypto/btc/convert.php?from=usd&value=109.78

Converts a fiat invoice amount into the crypto amount the customer should send.

Parameters

from: fiat currency

value: fiat amount

Example response

OK 200

{
  "status": "success",
  "value_coin": "0.00179614",
  "exchange_rate": "0.0000163613"
}

GET

Generate QR Code

GET

https://api.onramp-pay.com/crypto/btc/qrcode.php?address=3Ki3iFugZT1uFVZJSKwtT9sJ6C8BNPxigp&amount=0.00179614

Generates a base64 QR image for a generated receiving wallet. The amount parameter is optional and may be ignored by some wallets.

Parameters

address: generated address_in

amount: optional crypto amount

Example response

OK 200

{
  "status": "success",
  "qr_code": "base64_png_image",
  "payment_uri": "3Ki3iFugZT1uFVZJSKwtT9sJ6C8BNPxigp"
}

GET

Check Payment Status

GET

https://api.onramp-pay.com/crypto/payment-status.php?ipn_token=payment_tracking_token&ticker=bep20%2Fusdt

Checks crypto payment status for support or manual review. Production order updates should rely on callback events.

Parameters

ipn_token: token returned by Create Wallet

ticker: URL-encoded ticker path

Example response

OK 200

{
  "status": "paid",
  "value_coin": "110.53260075",
  "txid_in": "0x6623113f0997aae7d6a37ac2062cc2c2038f01626b94bb4d16faf8ef149bd04d",
  "txid_out": "0x1b0b28120be665c7f5c0810a92e9939f8fc6883a3e8273c5995eee6bcaec9c99",
  "coin": "bep20_usdt"
}

GET

Callback Event

GET

https://merchant.com/callback?invoice_id=75478385547922074&coin=btc&value_coin=0.00000546&txid_in=5d305...&txid_out=bc16...&address_in=bc1qx...&pending=0&value_forwarded_coin=0.0000053781

Onramp Pay calls your callback URL when funds are detected or confirmed. Original parameters are preserved, and transaction data is appended.

Parameters

value_coin: crypto amount paid

coin: coin and network ticker

txid_in: customer deposit transaction

txid_out: forwarding transaction

address_in: generated receiving wallet

pending: 1 for pending callback, 0 for confirmed

value_forwarded_coin: amount forwarded after fees

Example response

OK 200

Respond with plain text:

ok