Home
API Reference

Create Escrow Transfer Request

post
https://api.dev.cfx.to/v1/escrow-transfers/requests

Create a request for payment. A request is the intent that precedes an escrow_transfer: the recipient (addressed by phone, possibly before sign-up) is asked to be paid. When the sender later pays, call /accept with the resulting escrow transfer id to move the request to SENT.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Customer-scoped identity id of the requester (sender)

string
required
length between 3 and 16
^\+[1-9]\d{1,14}$

E.164 phone number of the requester

string
required
length between 3 and 16
^\+[1-9]\d{1,14}$

E.164 phone number to request payment from

string
required

Token symbol the request is denominated in — e.g. MOVEUSD

string
required

BigNumber-parseable human-decimal token amount (e.g. "1.31"), not raw base units

string
length ≤ 280

Optional human-readable note from the requester

string
length ≤ 2048

Optional 'tap to pay' link for the recipient SMS. Shortened via the short-URL service and embedded as the call-to-action. Not persisted on the request.

Headers
string
Responses

Updated 18 days ago

Did this page help you?
Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 18 days ago

Did this page help you?