Register the calling user's device for push notifications
Records a Firebase Cloud Messaging token so money events can reach the caller's device.
/v1/devicesRecords a Firebase Cloud Messaging token so money events can reach the caller's device. The token is bound to the wallet user behind the credential, and registering the same device again rebinds it, so this is safe to call on every app start. Answers 204 with no body. Refuses not_a_user (403) when the credential does not resolve to a wallet user in this tenant, invalid_request (400) when token is empty or platform is not android or ios, and push_disabled (501) on a deployment with no push service configured.
Authorization
bearerAuth A tenant API key (sk_{env}_{id}_{secret}), a wallet user token, or an IdP access token. Which principal the credential resolves to decides the scopes it carries; see the authentication guide.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/v1/devices" \ -H "Content-Type: application/json" \ -d '{ "token": "string", "platform": "android" }'A user's ledger history across cash and points
The user's own ledger entries across cash and points, newest first, each with the transaction it belongs to, its direction and its commodity.
Set a business user's credit line (audited; API keys only)
Sets a business user's credit line, the floor below zero its cash account may go.