Posteering
Reference

Provision an identity-blind FBO pool virtual account (partner perimeter).

Provisions a pooled-collection virtual account into the FBO master, attributed to the authenticated partner and an opaque holderRef. Identity-blind: no customer name/phone is accepted or stored. Each credit on the VA emits an attributed, balance-free funding-event (eventKind=fbo.funding) carrying the holderRef. Reference-only (no BRR). Returns 200 OK synchronously.

POST
/api/v1/bankrail/fbo/provision

Authorization

X-Bankrail-Key-Id<token>

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/fbo/provision" \  -H "Content-Type: application/json" \  -d '{    "holderRef": "holder-ref-2026-0001",    "callbackUrl": "https://partner.example.com/webhooks/bankrail/fbo-funding",    "purposeTag": "fbo_pool"  }'
{  "trackingId": "string",  "virtualAccount": "string",  "holderRef": "string",  "bankCode": "101",  "provider": "providus",  "providerChannel": "dcs",  "purposeTag": "string",  "createdAt": "2019-08-24T14:15:22Z"}
Empty
Empty
Empty