Exchange (client_id, client_secret) plus a DPoP proof for an OAuth 2.0 access token bound to your registered DPoP keypair. RFC 6749 §4.4 (client_credentials) + RFC 9449 §5.
Send credentials with HTTP Basic auth (Authorization: Basic <base64(client_id:client_secret)>). The body is also accepted. The DPoP header is required and MUST carry a proof JWT signed with your private DPoP key, with htm=POST, htu=https://api.../oauth/token, a fresh iat and jti, and NO ath claim (the access token does not exist yet).
A token lasts 1 hour in production and 8 hours in sandbox. There are no refresh tokens: call POST /oauth/token again for a fresh token.
Headers
DPoPstring · requiredDPoP proof JWT for this token request.
Body application/x-www-form-urlencoded
grant_typestring · requiredclient_credentialsclient_idstringOptional when supplied via Basic auth header.
client_secretstringOptional when supplied via Basic auth header.
Responses
200Access token minted.
access_tokenstring · requiredSigned JWT to send as Authorization: DPoP <token>.
token_typestring · requiredDPoPexpires_ininteger · requiredToken lifetime in seconds.
scopestring · requiredSpace-delimited granted scopes (RFC 6749 §3.3). They echo your credential's grants and match the values in the access token's scope claim, for example payouts intelligence.
400Invalid request, unsupported_grant_type, or invalid DPoP proof.
errorstring · requiredinvalid_requestinvalid_clientinvalid_grantunauthorized_clientunsupported_grant_typeinvalid_scopeinvalid_dpop_proofinvalid_tokenserver_errorerror_descriptionstring401`invalid_client`: the `client_id` is unknown or the secret is wrong. The response carries the `WWW-Authenticate` header (RFC 6749 section 5.
errorstring · requiredinvalid_requestinvalid_clientinvalid_grantunauthorized_clientunsupported_grant_typeinvalid_scopeinvalid_dpop_proofinvalid_tokenserver_errorerror_descriptionstring403Test client used in production.
errorstring · requiredinvalid_requestinvalid_clientinvalid_grantunauthorized_clientunsupported_grant_typeinvalid_scopeinvalid_dpop_proofinvalid_tokenserver_errorerror_descriptionstring