Set what an account requires before a payment leaves: the threshold, how many approvers, whether the requester may approve, how long a request waits

PUT/payment-approvals/policies/{account_id}

Path parameters

account_idstringRequired

Idempotency-KeystringOptional

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

approvers_requiredintegerOptional

1 (default) to 3

enabledboolean or nullOptional

expires_hoursintegerOptional

72 by default

self_approvalbooleanRequired

Whether the requester may approve

threshold_amountintegerRequired

Payments at or above wait for approval; 0 is every payment

tiersarray of objectsOptional

2 child attributes

approvers_requiredintegerRequired

threshold_amountintegerRequired

200 OK

account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

approvers_requiredintegerRequired

enabledbooleanRequired

expires_hoursintegerRequired

self_approvalbooleanRequired

threshold_amountintegerRequired

tiersarray of objectsOptional

2 child attributes

approvers_requiredintegerRequired

threshold_amountintegerRequired

updated_atstring · date-timeRequired

updated_bystringRequired

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503