Skip to content
GAMPEONCreate
New project

Approve or decline a payout

POST
/v1/admin/payouts/{id}/decision
curl --request POST \
--url https://api.gampeon.com/v1/admin/payouts/example/decision \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: example' \
--data '{ "decision": "approve", "reason": "example" }'

Never your own request. In sandbox mode no money moves.

Requires the role admin.

Not available with access tokens.

id
required
string

Payout ID (pay_…)

Idempotency-Key
required
string

Required. 8 to 100 characters (A-Z a-z 0-9 _ - : .). The same key with the same body returns the stored answer (replayed: true) without booking again.

Media typeapplication/json
object
decision
required
string
Allowed values: approve reject
reason

Reason, 5 to 500 characters. Stored in the audit log.

string
>= 5 characters <= 500 characters

Decided

Media typeapplication/json
object
payout
required
object
id
required
string
coins
required

Amount in GAMPEONS

integer
rateMicros
required

Rate fixed when the payout was requested

integer
currency
required
string
amountCents
required

Euro cents

integer
status
required
string
Allowed values: requested paid rejected
provider
required
string
reason
required
One of:
string
createdAt
required

Unix time in milliseconds

integer format: int64
decidedAt
required
One of:

Unix time in milliseconds

integer format: int64

Example

{
"payout": {
"status": "requested"
}
}

Error codes: invalid_field, idempotency_key_required

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: unauthorized

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: forbidden, token_not_allowed, four_eyes_required

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: not_found

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: payout_not_open, idempotency_conflict

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: payments_disabled

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Report a problem with this pageOther ways to give feedback