Create Onramp URL

Create Onramp URL

post

Creates an onramp URL for cryptocurrency purchase using fiat currency. This endpoint generates a URL that redirects users to the onramp provider's payment widget where they can buy crypto using fiat currency.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key for authentication. Include as: Bearer YOUR_API_KEY

Body

application/json

Request to create MELD onramp URL for crypto purchase

providerstring · enumRequired

Onramp provider (e.g., MELD)

Possible values:

merchant_idstring · uuidOptional

Merchant identifier (optional)

currency_idstring · uuidRequired

Currency ID for the crypto to purchase

user_reference_idstringRequired

Unique user reference identifier

countrystringRequired

User's country code following ISO 3166-1 alpha-2 standard (e.g., US, GB, DE)

Pattern: ^[A-Z]{2}$

languagestringOptional

Language code for the onramp provider interface

Default: en

operationstring · enumRequired

Operation type for the onramp transaction

Default: depositPossible values:

sitestringRequired

Site identifier for redirect URL (e.g., sportsbet.io, bitcasino.io, livecasino.io)

themestring · enumRequired

UI theme for the onramp provider widget

Default: darkPossible values:

Responses

200

Successfully created onramp URL

application/json

Response containing onramp provider URL

successbooleanRequired

Operation success status

400

Bad Request - Missing or unsupported provider

application/json

401

Unauthorized - Invalid or missing API key

application/json

422

Validation Error - Invalid parameters

application/json

post

/v1/user/onramp/get_url

HTTPcURLJavaScriptPython

POST /v1/user/onramp/get_url HTTP/1.1
Host: gateway.stage.pay.io
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 194

{
  "provider": "MELD",
  "currency_id": "c872e749-fd56-533e-b01f-de87ae38e7f1",
  "user_reference_id": "hub_player_2",
  "country": "US",
  "operation": "deposit",
  "site": "sportsbet",
  "theme": "dark",
  "language": "en"
}

{
  "success": true,
  "data": {
    "link": "https://sb.meldcrypto.com/?publicKey=xxx&redirectUrl=xxx&countryCode=US&destinationCurrencyCodeLocked=USDT_TRON&walletAddressLocked=TTestWalletAddress&theme=darkMode&externalCustomerId=hub_player_2&transactionType=BUY&language=en"
  }
}