Listar métodos de pago

curl https://api.onepay.la/v1/customers/session/payment-methods \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "X-Customer-Token: 12|a1b2c3d4e5f6..."

const response = await fetch('https://api.onepay.la/v1/customers/session/payment-methods', {
  headers: {
    'Authorization': 'Bearer sk_test_xxx',
    'X-Customer-Token': '12|a1b2c3d4e5f6...'
  }
});

const { data } = await response.json();
console.log(data.cards);    // Tarjetas
console.log(data.wallets);  // Nequi/Daviplata
console.log(data.pse);      // Cuentas PSE

import requests

response = requests.get(
    'https://api.onepay.la/v1/customers/session/payment-methods',
    headers={
        'Authorization': 'Bearer sk_test_xxx',
        'X-Customer-Token': '12|a1b2c3d4e5f6...'
    }
)

data = response.json()['data']

{
  "data": {
    "cards": [
      {
        "id": "bb02b2fd-154c-4c90-9fdf-cec3a0b25cf5",
        "brand": "visa",
        "last_four": "4242",
        "label": "Visa ····4242",
        "expiration_date": "2028-12-31",
        "card_name": "MARIA LOPEZ"
      }
    ],
    "wallets": [
      {
        "id": "a1b2c3d4-5678-9abc-def0-123456789abc",
        "subtype": "nequi",
        "phone": "3001234567",
        "label": "NEQUI ····4567"
      }
    ],
    "pse": [
      {
        "id": "c3d4e5f6-7890-abcd-ef01-234567890def",
        "bank_name": "Bancolombia",
        "label": "Bancolombia - PSE"
      }
    ]
  }
}

{
  "message": "Token de sesión inválido o expirado."
}

GET

customers

session

payment-methods

curl https://api.onepay.la/v1/customers/session/payment-methods \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "X-Customer-Token: 12|a1b2c3d4e5f6..."

const response = await fetch('https://api.onepay.la/v1/customers/session/payment-methods', {
  headers: {
    'Authorization': 'Bearer sk_test_xxx',
    'X-Customer-Token': '12|a1b2c3d4e5f6...'
  }
});

const { data } = await response.json();
console.log(data.cards);    // Tarjetas
console.log(data.wallets);  // Nequi/Daviplata
console.log(data.pse);      // Cuentas PSE

import requests

response = requests.get(
    'https://api.onepay.la/v1/customers/session/payment-methods',
    headers={
        'Authorization': 'Bearer sk_test_xxx',
        'X-Customer-Token': '12|a1b2c3d4e5f6...'
    }
)

data = response.json()['data']

{
  "data": {
    "cards": [
      {
        "id": "bb02b2fd-154c-4c90-9fdf-cec3a0b25cf5",
        "brand": "visa",
        "last_four": "4242",
        "label": "Visa ····4242",
        "expiration_date": "2028-12-31",
        "card_name": "MARIA LOPEZ"
      }
    ],
    "wallets": [
      {
        "id": "a1b2c3d4-5678-9abc-def0-123456789abc",
        "subtype": "nequi",
        "phone": "3001234567",
        "label": "NEQUI ····4567"
      }
    ],
    "pse": [
      {
        "id": "c3d4e5f6-7890-abcd-ef01-234567890def",
        "bank_name": "Bancolombia",
        "label": "Bancolombia - PSE"
      }
    ]
  }
}

{
  "message": "Token de sesión inválido o expirado."
}

Retorna todos los métodos de pago verificados y vigentes del cliente autenticado, agrupados por tipo: tarjetas, billeteras digitales (Nequi/Daviplata) y cuentas PSE.

Solo se retornan métodos de pago verificados, no expirados y del mismo modo (test/live) que el token de la empresa.

Headers

Authorization

string

required

Bearer token de tu empresa: Bearer sk_test_xxx o Bearer sk_live_xxx.

X-Customer-Token

string

required

Token de sesión del cliente obtenido en /customers/login/verify.

Respuesta

data

object

Objeto con los métodos de pago agrupados por tipo.

Show Propiedades

data.cards

array

Tarjetas de crédito/débito verificadas y vigentes.

Show Propiedades de cada tarjeta

string

ID de la tarjeta.

brand

string

Marca: visa, mastercard, amex, diners.

last_four

string

Últimos 4 dígitos.

label

string

Etiqueta legible (ej. Visa ····1234).

expiration_date

string

Fecha de expiración (YYYY-MM-DD).

card_name

string

Nombre del titular.

data.wallets

array

Billeteras digitales conectadas (Nequi, Daviplata).

Show Propiedades de cada billetera

string

ID de la cuenta.

subtype

string

Tipo: nequi o daviplata.

phone

string

Número de teléfono asociado.

label

string

Etiqueta legible (ej. NEQUI ····4567).

data.pse

array

Cuentas PSE conectadas.

Show Propiedades de cada cuenta PSE

string

ID de la cuenta.

bank_name

string

Nombre del banco.

label

string

Etiqueta legible (ej. Bancolombia - PSE).

curl https://api.onepay.la/v1/customers/session/payment-methods \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "X-Customer-Token: 12|a1b2c3d4e5f6..."

const response = await fetch('https://api.onepay.la/v1/customers/session/payment-methods', {
  headers: {
    'Authorization': 'Bearer sk_test_xxx',
    'X-Customer-Token': '12|a1b2c3d4e5f6...'
  }
});

const { data } = await response.json();
console.log(data.cards);    // Tarjetas
console.log(data.wallets);  // Nequi/Daviplata
console.log(data.pse);      // Cuentas PSE

import requests

response = requests.get(
    'https://api.onepay.la/v1/customers/session/payment-methods',
    headers={
        'Authorization': 'Bearer sk_test_xxx',
        'X-Customer-Token': '12|a1b2c3d4e5f6...'
    }
)

data = response.json()['data']

{
  "data": {
    "cards": [
      {
        "id": "bb02b2fd-154c-4c90-9fdf-cec3a0b25cf5",
        "brand": "visa",
        "last_four": "4242",
        "label": "Visa ····4242",
        "expiration_date": "2028-12-31",
        "card_name": "MARIA LOPEZ"
      }
    ],
    "wallets": [
      {
        "id": "a1b2c3d4-5678-9abc-def0-123456789abc",
        "subtype": "nequi",
        "phone": "3001234567",
        "label": "NEQUI ····4567"
      }
    ],
    "pse": [
      {
        "id": "c3d4e5f6-7890-abcd-ef01-234567890def",
        "bank_name": "Bancolombia",
        "label": "Bancolombia - PSE"
      }
    ]
  }
}

{
  "message": "Token de sesión inválido o expirado."
}

Verificar OTP

Tokenizar tarjeta

API

Empresas

Métodos de pago

Recaudo

Balances

Webhooks

Fintech as a service

Headers

Respuesta

​Headers

​Respuesta

Headers

Respuesta