Skip to main content
POST
Create payment route

Authorizations

Authorization
string
header
required

API key created in the Remitflex Dashboard at dashboard.remitflex.io (rmf_live_... or rmf_test_...). Key management endpoints require a dashboard JWT and are not part of this reference.

Headers

Idempotency-Key
string
required

Unique key for safe retries on mutating API-key requests. Cached for 24 hours per org, method, and path.

Maximum string length: 255
Example:

"7f3c2a1b-4e5d-6c7b-8a9f-0e1d2c3b4a5f"

Body

application/json

Specify networks with originChainKey / destinationChainKey. Use token codes like USDC for destinationCurrency.

name
string
required
Required string length: 2 - 80
originChainKey
string
required

Origin network key from GET /payment-routes/chains (e.g. tron, bitcoin).

destinationChainKey
string
required

Settlement network — base or solana.

destinationCurrency
string
required

Token code — USDC or USDT on Base; USDC, USDT, or EURC on Solana.

Required string length: 2 - 128
destinationAddress
string
required
Required string length: 8 - 128
originCurrency
string

Optional token code on the origin network.

Required string length: 2 - 128
refundTo
string
Required string length: 8 - 128
strict
boolean
default:false
customerId
string
Required string length: 1 - 128
payerSource
enum<string>
Available options:
wallet,
exchange

Response

201 - application/json

Payment route

status
string
Example:

"success"

message
string
data
object