Skip to main content
PUT
Prepare 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.

Response

Default Response

data
object
required
duplicates
object

Non-blocking warning returned by the sign step when payments matching an existing payee/amount within the lookback window are found. Informational only — it does not block signing or execution. The hard duplicate rejection (HTTP 409) happens at execute time, keyed on salt and external_id, not here.