List available payment methods
Returns payment methods available to the caller for the current checkout context. Two auth flows are supported: (1) client_secret — the session derives currency, merchant, and country; query params are ignored. (2) publishable_key — the currency query parameter is REQUIRED and the merchant is taken from the API key owner. Use this endpoint to render payment method selection in HPP or SDK flows.
Authorization
bearer In: header
Query Parameters
ISO 4217 alpha-3 currency code (e.g. "USD", "EUR"). Required for publishable-key auth; ignored for client-secret auth (derived from session).
ISO 3166-1 alpha-2 country code (e.g. "US", "DE"). Optional — narrows the result set to methods available in the given country.
Response Body
application/json
curl -X GET "https://<api-host>/v1/payment-methods"{
"data": [
{
"type": "card",
"method": "string",
"name": "string",
"brands": [
"string"
],
"issuers": [
{
"id": "string",
"name": "string"
}
],
"inputDetails": [
{
"key": "string",
"type": "string",
"required": true
}
]
}
],
"pagination": {
"nextCursor": "string",
"prevCursor": "string",
"hasMore": true,
"totalCount": 0
}
}List financial statements
Returns a paginated list of financial statements visible to the caller. Filters: `merchantId`, `terminalId`, `currency`, `status`, `periodFrom`, `periodTo`. Cursor-based pagination — default page size 20, maximum 100.
Cancel payment
Cancels a payment that has not yet been captured. Valid for payments in `processing`, `requires_action`, or `requires_capture` status — cancellation voids the authorization without creating a refund. Returns 409 if the payment is already captured or in a terminal state.