Issue a BRR (Bankrail Retrieval Reference) — partner perimeter.
Mints a BRR as a standalone act, ahead of any payment. The authenticated partner (req.user.partnerId from PartnerHmacGuard) is recorded as the issuer; the partner's customer class and tier are read from bankrail.partners. Returns 200 OK with the opaque BRR token the payer presents and the backing vault row id. Standalone BRR issuance is a BRR-level capability: it succeeds for government and corporate partners; fintech and citizen partners receive a 403 (BRR_NOT_AVAILABLE_FOR_CUSTOMER_CLASS). One route and one schema serve every class — the outcome is categorised by the partner's customer class.
Partner-visible credential identifier issued by bank-rail at credential provisioning time. Names which credential signed the request; the corresponding signing secret never appears in any request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/api/v1/bankrail/tokens" \ -H "Content-Type: application/json" \ -d '{ "purposeTag": "gov.collection.fed.vat" }'{ "brr": "BRR-0123456789ABCDEF01234567", "vaultRowId": "6efeb91c-c464-401e-91bd-87e0e019f574"}List the caller's outbound transfers (money out; poll surface). GET
Previous Page
Validate the status of a transaction by its BRR — partner perimeter. GET
Returns the current lifecycle status of the collection transaction identified by the supplied BRR. The authenticated partner may query only BRRs belonging to their own transactions; a BRR that resolves to another partner's transaction, or to no transaction, returns 404.