TRtrytoku
Payment Methods

Obtener Payment Method

Changed on

Obsoleto. Usar GET /payment-methods/{id}, que entrega la misma información y acepta las versiones posteriores al 2024-05-22. Este endpoint se mantiene por compatibilidad y se va a retirar.

Devuelve un Payment Method con sus datos agregados.

Junto al medio de pago devuelve el Customer, el gateway, la Account y los productos y Subscriptions asociados, para no tener que consultarlos por separado.

Acepta el identificador de Toku (id) o el de la Organization (external_id). Si se envían ambos, se usa id.

Acepta el header x-api-version para elegir la versión de la respuesta, la misma que entrega GET /payment-methods/{id}. Si no se envía, o es anterior al 2024-05-22, se usa la versión de esa fecha.

get/payment_method

Request

  • Base URL
    https://api.trytoku.com
  • URL
    https://api.trytoku.com/payment_method
  • Auth
    API key in header x-api-key

Query parameters

idstring

Identificador del Payment Method. Alternativo a external_id; debe venir uno de los dos.

external_idstring

Identificador del Payment Method en el sistema de la Organization. Se usa cuando no se tiene id; si ambos vienen, manda id.

Headers

x-api-versionstring date

Versión del API para esta petición, como cualquier fecha YYYY-MM-DD. Fija el contrato de la respuesta; si se omite, se deriva de la fecha de creación de la organización.

Example:2026-10-08
x-account-keystring

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

Response

Successful Response

gateway'transbank_oneclick' | 'klap_oneclick' | 'patpass' | 'toku_pac' | 'fintoc_pac' | 'universo_pac' | 'external_pac' | 'ecert_pac' | 'manual_pac' | 'internal_psp' | 'domiciliation' | 'mx_banco_bbva' | 'mx_banco_bancomer' | 'mx_banco_banbajio' | 'mx_banco_banorte' | 'mx_banco_banorte_h2h' | 'mx_banco_banregio' | 'mx_banco_bbva_bancomer' | 'mx_banco_citibanamex' | 'mx_banco_santander' | 'mx_banco_scotiabank' | 'mx_banco_scotiabank_h2h_external' | 'evo_payments' | 'conekta' | 'stripe' | 'kushki' | 'openpay' | 'paypal' | 'getnet' | 'fiserv' | 'transbank' | 'toku_gateways' | 'payment_orchestration' | 'cards_batch_mx' | 'cards_batch_mx_recurring_pst' | 'amex_batch_mx_recurring_pst' | 'atoa_batch_mx_recurring_pst' | 'braintree' | 'cielo' | 'pagarme' | 'belvo' | 'iniciador' | 'qi_tech' | 'mit' | 'mit_amex' | 'rede' | 'br_banco_do_brasil' | 'br_banco_itau' | 'br_banco_santander' | 'br_banco_citibank' | 'br_banco_de_brasilia_via_accesstage' | 'br_santander_via_accesstage' | 'br_bradesco_via_accesstage' | 'br_banco_do_brasil_via_accesstage' | 'br_c6_via_accesstage' | 'br_sicoob_via_accesstage' | 'br_caixa_via_accesstage' | 'br_itau_via_accesstage' | 'br_santander_brasil_via_accesstage' | 'br_sudameris_via_accesstage' | 'br_abn_via_accesstage' | 'br_inter_via_accesstage' | 'br_hsbc_via_accesstage' | 'br_sicoob' | 'worldpay' | 'br_caixa' | 'br_btg' | 'br_banco_itau_boleto' | 'br_banco_bradesco_boleto' | 'br_sicredi_boleto' | 'br_banco_de_brasilia'

Integración a través de la cual se inscribió un medio de pago y por la que se cobrará después. Combina el adquirente o banco con la modalidad de inscripción — por ejemplo transbank_oneclick es una tarjeta inscrita en Oneclick de Transbank, y fintoc_pac un mandato de descuento automático inscrito vía Fintoc.

Es un conjunto distinto de PaymentIntentGateway, que identifica por dónde sale un cobro puntual: no todo gateway capaz de cobrar sirve para inscribir un medio de pago.

id_accountstring
id_checkout_sessionstring
product_idsstring[] required
subscription_idsstring[] required

Changes