Request flow - Numpay Docs

Request types

Type	Payer	Created with	Link
`DIRECT`	One phone number or email	`POST /api/request`	`{BASE_URL}/send?requestId={id}`
`GLOBAL`	Anyone signed in	`POST /api/request/global`	`{BASE_URL}/send?requestId={id}`

BASE_URL is the app origin, https://app.numpay.app in production.

Creating a direct request

A global request skips the payer lookup: POST /api/request/global { requesterId, amountRequested, message }.

Paying a request

States

Only PENDING requests can be cancelled. GET /api/request/get/all/{userId} lists every request a user made or was asked to pay; GET /api/request/pending/{userId} lists the pending requests waiting for that user to pay.

Numpay doesn’t yet notify the payer by SMS or email. The requester shares the link.