Saltar al contenido principal
GET
List payment methods
v2 · Base URL https://api.fintoc.com/v2

Autorizaciones

Authorization
string
header
requerido

Parámetros de consulta

payment_options
object
customer
string

Unique identifier of the customer that owns the payment methods. If present, the response only includes payment methods that belong to this customer.

ending_before
string

Pagination cursor. The id of a payment method; the response contains the page of more recent payment methods, the ones listed before the cursor. Cannot be combined with starting_after.

limit
integer
predeterminado:30

Maximum number of payment methods to return per page, up to 300. Defaults to 30.

starting_after
string

Pagination cursor. The id of a payment method; the response contains the page of older payment methods, the ones listed after the cursor. Cannot be combined with ending_before.

Respuesta

List of payment methods for the current mode, sorted by most recently created first. The type-specific details key is null when the resource backing a payment method is no longer available.

A payment method represents a customer's stored payment instrument, ready to be charged without the customer going through the full authorization flow again. The shape of the object depends on its type: the type-specific details live under a key named after the type (bank_transfer, card, or pac).

id
string
requerido

Unique identifier of the payment method.

Ejemplo:

"pm_1zXcVbNmAsDfGhJk"

object
any
requerido

Type of the object. Always payment_method.

bank_transfer
object | null
requerido

Details of the linked bank account that pays the transfers. null when the linked account backing the payment method is no longer available.

created_at
string<date-time>
requerido

ISO 8601 timestamp of when the payment method was created.

Ejemplo:

"2026-01-15T14:30:00.000Z"

customer
string
requerido

Unique identifier of the customer the payment method belongs to.

Ejemplo:

"cus_oVgVqlnK0PdmGirH"

mode
enum<string>
requerido

Mode of the payment method. live payment methods charge real money; test payment methods use fake data for integration testing.

Opciones disponibles:
live,
test
Ejemplo:

"live"

type
any
requerido

Type of the payment method. Always bank_transfer.