Fetch a charge
Scoped to your business and your key's mode. Someone else's charge and a charge that does not exist give the same 404, on purpose — telling them apart tells an attacker which ids are real.
Scoped to your business and your key's mode.
Someone else's charge and a charge that does not exist give the same 404, on purpose — telling them apart tells an attacker which ids are real.
Path Parameters
uuidResponse Body
application/json
application/json
curl -X GET "https://example.com/api/b/v1/charges/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "reference": "string", "amount_minor": 0, "fee_minor": 0, "net_minor": 0, "refunded_minor": 0, "currency": "string", "status": "string", "channel": "string", "failure_reason": "string", "is_test": true, "created_at": "2019-08-24T14:15:22Z", "confirmed_at": "2019-08-24T14:15:22Z"}Create a charge POST
Take a payment. A repeated `idempotency_key` returns the original charge with 201 rather than a conflict. A client that did not hear our answer and asked again wants the charge, not an error it has to interpret.
Businesses the caller belongs to GET
Every business this user holds a role in. Requires only a consumer token, because this is how somebody discovers what they can switch into.