Move the client's settlement money into its marketing account
Moves money from the client's settlement balance into its marketing account, where cashback rules draw from.
/v1/clients/{clientId}/marketing/fundMoves money from the client's settlement balance into its marketing account, where cashback rules draw from. Requires an Idempotency-Key; the funding id is derived from it, so a crash- retry replays the same posting instead of moving the money twice. Needs authority over the client — membership of its organization, an API key bound to this client, or tenant staff holding clients:manage; anything else is refused not_client_member or insufficient_scope (403), and an unknown client client_not_found (404). Refuses invalid_request (400), insufficient_funds (422) when the settlement balance does not cover it, and idempotency_key_reuse (409) when the key comes back with a different body.
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
Path Parameters
uuidHeader Parameters
1 <= length <= 200Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/v1/clients/497f6eca-6276-4993-bfeb-53cbbbba6f08/marketing/fund" \ -H "Idempotency-Key: string" \ -H "Content-Type: application/json" \ -d '{ "amount": 1 }'{ "txn_id": "3dd6ecc9-94bf-4fc7-98ae-cdbe5b6f62e4", "amount": 0}