Organization API: Billing & Payouts: Commerce
The 3 Organization API operations for commerce.
Part of Billing & Payouts.
Operations
Section titled Operations| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/orgs/{org_slug}/commerce/payouts |
List payouts |
| POST | /api/v1/orgs/{org_slug}/commerce/payouts |
Ask for the payable balance in a currency now |
| GET | /api/v1/orgs/{org_slug}/commerce/payouts/{payout_id} |
The payout and the ledger rows it holds, oldest first |
List payouts
Section titled List payoutsGET /api/v1/orgs/{org_slug}/commerce/payouts
Newest first, with summary: the schedule and, per currency, what is
payable now, the minimum and any payout still open.
Parameters
Section titled Parameters| Name | In | Type | Required | Description |
|---|---|---|---|---|
org_slug |
path | string | yes | |
status |
query | string or null | no | A status, or open for both open ones. |
currency_code |
query | string or null | no | |
limit |
query | integer | no | Default: 50. |
offset |
query | integer | no | Default: 0. |
Responses
Section titled Responses| Status | Meaning |
|---|---|
200 |
Success. |
422 |
The request is not valid. detail lists each problem. |
Ask for the payable balance in a currency now
Section titled Ask for the payable balance in a currency nowPOST /api/v1/orgs/{org_slug}/commerce/payouts
Ask for the payable balance in a currency now. 409 with error
nothing_payable, below_minimum, payout_open or held when
there is none to make; the balance carries.
Parameters
Section titled Parameters| Name | In | Type | Required |
|---|---|---|---|
org_slug |
path | string | yes |
Idempotency-Key |
header | string or null | no |
Request body
Section titled Request bodyapplication/json (required)
| Field | Type | Required |
|---|---|---|
currency_code |
string | yes |
Responses
Section titled Responses| Status | Meaning |
|---|---|
201 |
Success. |
422 |
The request is not valid. detail lists each problem. |
The payout and the ledger rows it holds, oldest first
Section titled The payout and the ledger rows it holds, oldest firstGET /api/v1/orgs/{org_slug}/commerce/payouts/{payout_id}
The payout and the ledger rows it holds, oldest first.
Parameters
Section titled Parameters| Name | In | Type | Required | Description |
|---|---|---|---|---|
payout_id |
path | string | yes | |
org_slug |
path | string | yes | |
limit |
query | integer | no | Ledger rows per page. Default: 100. |
offset |
query | integer | no | Default: 0. |
Responses
Section titled Responses| Status | Meaning |
|---|---|
200 |
Success. |
422 |
The request is not valid. detail lists each problem. |