Skip to main content
POST
Execute instant payment (V1 Legacy)

Body

application/json
wallet
string
required

Wallet address of the payer.

rise_id
required

RiseID, address, or team nanoid of the paying team.

payee
required

RiseID, address, or user nanoid of the payee.

amount
required

Payment amount in micro-USD (1,000,000 = $1.00).

salt
required

Uniqueness value for this payment. Rise derives the payment on-chain id from (paying team account, payee, amount, salt); repeating that exact combination is rejected as a duplicate (HTTP 409). Salt alone is not the idempotency key — the same salt with a different payee or amount creates a distinct payment. Use external_id for a caller-controlled idempotency key.

request
object
required

The typed-data request object returned by the sign step.

signature
string
required

Signature over the typed data returned by the sign step.

title
string

Optional payment title (max 60 chars).

description
string

Optional payment description (max 1000 chars).

external_id
string

Optional caller-supplied reference (max 500 characters; longer values are truncated). Also acts as a per-payer idempotency key: reusing an external_id already used by this payer is rejected with HTTP 409 (EXTERNAL_ID_ALREADY_USED). Independent of salt. Returned on each payment and filterable via the external_ids query parameter on list-payments.

Response

Default Response

data
object
required

ethers-v5-shaped transaction receipt, matching V1.