Treli API
Docs
Soporte
  1. Métodos de pago
  • Introducción
  • Autenticación
  • Errores
  • Códigos de rechazo
  • Suscripciones
    • Suscripción
    • Crear suscripción
      POST
    • Actualizar suscripción
      POST
    • Cancelar suscripción
      POST
    • Obtener suscripción
      GET
    • Eliminar descuento
      DELETE
    • Pausar suscripción
      POST
    • Reanudar suscripción
      POST
    • Listar suscripciones
      GET
    • Migrar suscripción
      POST
  • Items de suscripción
    • Obtener item de suscripción
      GET
    • Eliminar item de suscripción
      DELETE
    • Actualizar item de suscripción
      POST
    • Crear item de suscripción
      POST
  • Clientes
    • Cliente
    • Crear cliente
      POST
    • Actualizar cliente
      POST
    • Obtener cliente
      GET
    • Listar clientes
      GET
    • Registrar pago de facturas
      POST
  • Cobros
    • Cobro
    • Crear cobro
    • Registrar cobro parcial
    • Enviar notificación de cobro
    • Anular cobro
    • Marcar como incobrable
    • Pagar un cobro
    • Obtener un cobro
    • Listar cobros
    • Modificar total del cobro
    • Modificar items del cobro
    • Modificar descuentos del cobro
    • Eliminar descuento
    • Marcar cobro como reembolsado
  • Facturas
    • Cargar factura
    • Obtener factura
    • Listar facturas
    • Anular factura
    • Pagar una factura
  • Notas de crédito
    • Nota de crédito
    • Crear nota de crédito
    • Anular nota de crédito
    • Obtener nota de crédito
  • Productos
    • Crear producto
    • Actualizar producto
    • Obtener un producto
    • Listar productos
    • Eliminar producto
  • Precios
    • Eliminar precio
    • Crear precio
    • Actualizar precio
    • Obtener un precio
    • Listar precios
  • Cargos
    • Listar cargos
  • Enlaces de pago
    • Crear enlace de pago
  • Sesión de checkout
    • Sesión de checkout
    • Crear sesión de checkout
    • Obtener sesión de checkout
  • Sesión de portal
    • Sesión de portal
    • Crear sesión de portal
  • Cupones
    • Cupón
    • Crear cupón
    • Obtener un cupón
    • Eliminar un cupón
    • Actualizar cupón
    • Listar cupones
  • Pagos de facturas
    • Pago de facturas
    • Listar pagos de facturas
  • Eventos
    • Evento
    • Tipos de eventos
    • Webhooks
  • Catálogo de parámetros por país
    • Colombia
  • Métodos de pago
    • Listar métodos de pago de un cliente
      GET
    • Migrar método de pago
      POST
  • Schemas
    • Subscriptions
      • Suscripción
      • Actualizar suscripción
    • Customers
      • Customer
    • Cobros
      • Cobro
    • Facturas
      • Factura
    • Items
    • Producto
    • Precio
    • Descuentos
    • Billing Address
    • Evento
    • Delete object
    • Enlace de pago
    • Sesión de checkout
    • Cupón
    • Pago de facturas
    • Payment information
    • Nota de crédito
    • Transacción
    • Cargo
    • Payment method
    • Sesión de portal
  1. Métodos de pago

Migrar método de pago

POST
/v1/payment_methods/migrate
Importa un método de pago existente desde una pasarela externa y lo asocia a un cliente en Treli. Este endpoint está pensado para migraciones, donde ya cuentas con los tokens y datos de la tarjeta almacenados en la pasarela de origen.

Pasarelas y tipos soportados#

Solo se aceptan combinaciones de pasarela y tipo que soporten migración de tokens:
PasarelaTipos
wompicard, nequi, daviplata
epayco, payu, openpay, mercadopago, stripe, placetopay, paymentswaycard
La pasarela debe estar configurada en la cuenta del comercio.

Datos requeridos#

customer — Cliente al que se asociará el método de pago.
gateway y type — Pasarela y tipo del método de pago.
tokens — Tokens del método de pago en la pasarela. Los campos requeridos varían según la pasarela (por ejemplo, token_id para la mayoría; setup_intent y customer_id para Stripe; device_session_id y customer_id para Openpay).
card_details — Requerido cuando type es card (exp_year, exp_month, y opcionalmente brand y last4).

Dirección de facturación#

Puedes enviar billing_address en la solicitud. Si no la envías, Treli intentará usar la información de facturación del cliente. Si el cliente no tiene datos de facturación completos, la solicitud fallará.

Request

Authorization
Send your HTTP requests with an
Authorization
header that contains the word Basic followed by a space and a base64-encoded string username:password
Example:
Authorization: Basic *****************
Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.treli.co/v1/payment_methods/migrate' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '{
    "customer": "cus_TgfdA2vL9rnWblZM8LtWMsdY",
    "gateway": "wompi",
    "type": "card",
    "card_details": {
        "exp_year": "2028",
        "exp_month": "03",
        "brand": "visa",
        "last4": "4242"
    },
    "tokens": {
        "token_id": "tok_1ABC123",
        "customer_id": "cus_1ABC123",
        "setup_intent": "seti_1ABC123",
        "device_session_id": "kjsdf9823jsdf9823"
    },
    "billing_address": {
        "first_name": "Juan",
        "last_name": "Pérez",
        "address_1": "Calle 123 #45-67",
        "city": "Bogotá",
        "state": "Cundinamarca",
        "postcode": "110111",
        "country": "CO",
        "identification": "1234567890",
        "id_type": "CC"
    }
}'
Response Response Example
{
    "id": "string",
    "created_date": "2019-08-24T14:15:22.123Z",
    "is_test": true,
    "gateway": "string",
    "type": "card",
    "nequi": {
        "phone": "string"
    },
    "card": {
        "brand": "string",
        "exp_year": 0,
        "exp_month": 0,
        "last4": "string",
        "expired": true
    },
    "billing_address": {
        "first_name": "string",
        "last_name": "string",
        "address_1": "string",
        "city": "string",
        "state": "string",
        "postcode": "string",
        "country": "string",
        "identification": "string",
        "id_type": "string"
    },
    "is_default": true,
    "is_debit": true
}
Previous
Listar métodos de pago de un cliente
Next
Suscripción
Built with