Create billing configuration

Creates a billing configuration for a buyer the merchant has onboarded. The buyer must be accepted; a buyer in any other state gets a 422.

Only bank_transfer is available: direct_debit is not available via the API yet.

A second call for the same buyer returns a 422 with the uuid of the existing billing configuration in the error details.

The billing_configuration_uuid from the 201 response can be used for orders with payment_method billing_statement right away, or taken from the billing_configuration/created webhook. If an order comes back with a 422 on billing_configuration_uuid, retry it after the webhook. If the webhook does not arrive, check GET /api/v1/buyers/{buyer_uuid}/billing_configurations.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$

Buyer identifier.

Body Params
integer
required
≥ 0

Days from the generation of a statement until it is due.

string
enum
required
Allowed:
integer
required
≥ 0

Days from the end of a billing period until its statement is generated.

string
enum
required

direct_debit is not available via the API yet.

Allowed:
billing_contact
object
required
Responses

403

Forbidden

404

Not Found

422

Unprocessable Entity

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json