Obtener Métodos de Pago

Obtiene todos los métodos de pago disponibles agrupados por país.

Endpoint

GET /v1/payment-methods

Autenticación

Requiere API Key con header X-API-KEY.

Países Soportados

Código	País	Moneda
AR	Argentina	ARS
BR	Brasil	BRL
CL	Chile	CLP
CO	Colombia	COP
MX	México	MXN

Ejemplo de Solicitud

cURL

curl -X GET "https://api.alohapay.co/api/external/v1/payment-methods" \
  -H "X-API-KEY: tu_api_key_aqui"

JavaScript

const response = await fetch(
  'https://api.alohapay.co/api/external/v1/payment-methods',
  {
    headers: {
      'X-API-KEY': 'tu_api_key_aqui'
    }
  }
);
const data = await response.json();

console.log('Métodos de pago:', data.data);

Python

import requests

headers = {
    'X-API-KEY': 'tu_api_key_aqui'
}

response = requests.get(
    'https://api.alohapay.co/api/external/v1/payment-methods',
    headers=headers
)
data = response.json()

print('Métodos de pago:', data['data'])

PHP

<?php
$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.alohapay.co/api/external/v1/payment-methods',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-KEY: tu_api_key_aqui'
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

print_r($data['data']);

Respuesta Exitosa (200 OK)

{
  "success": true,
  "message": "Payment methods retrieved successfully",
  "data": [
    {
      "country_code": "AR",
      "country_name": "Argentina",
      "currency": "ARS",
      "payment_methods": [
        {
          "name": "Pago con QR",
          "description": "Pago por QR."
        },
        {
          "name": "Tarjetas de Crédito/Débito",
          "description": "Pago con tarjeta de crédito o débito."
        },
        {
          "name": "CVU",
          "description": "Transferencia por CVU."
        }
      ]
    },
    {
      "country_code": "BR",
      "country_name": "Brazil",
      "currency": "BRL",
      "payment_methods": [
        {
          "name": "Pago con PIX",
          "description": "Pago con QR o Copia e Cola."
        }
      ]
    },
    {
      "country_code": "CL",
      "country_name": "Chile",
      "currency": "CLP",
      "payment_methods": [
        {
          "name": "Paga con tu banco",
          "description": ""
        },
        {
          "name": "Webpay",
          "description": "Tarjeta de Crédito, Débito o Prepaga."
        }
      ]
    },
    {
      "country_code": "CO",
      "country_name": "Colombia",
      "currency": "COP",
      "payment_methods": [
        {
          "name": "PSE",
          "description": "Transferencia Bancaria."
        },
        {
          "name": "Bancolombia",
          "description": "Transferencia Bancaria."
        },
        {
          "name": "Nequi",
          "description": "Transferencia Bancaria."
        },
        {
          "name": "Daviplata",
          "description": "Transferencia Bancaria."
        }
      ]
    },
    {
      "country_code": "MX",
      "country_name": "Mexico",
      "currency": "MXN",
      "payment_methods": [
        {
          "name": "Transferencia Bancaria",
          "description": "Pago a Clabe de un solo uso."
        }
      ]
    }
  ]
}

Campos de Respuesta

Campo	Tipo	Descripción
data	array	Lista de países con sus métodos de pago
data[].country_code	string	Código ISO del país (2 letras)
data[].country_name	string	Nombre del país
data[].currency	string	Código de moneda ISO 4217
data[].payment_methods	array	Lista de métodos de pago disponibles
data[].payment_methods[].name	string	Nombre del método de pago
data[].payment_methods[].description	string	Descripción del método de pago

Métodos de Pago por País

Argentina (AR)

Método	Descripción
Pago con QR	Pago por QR
Tarjetas de Crédito/Débito	Pago con tarjeta de crédito o débito
CVU	Transferencia por CVU

Brasil (BR)

Método	Descripción
Pago con PIX	Pago con QR o Copia e Cola

Chile (CL)

Método	Descripción
Paga con tu banco	Transferencia bancaria directa
Webpay	Tarjeta de Crédito, Débito o Prepaga

Colombia (CO)

Método	Descripción
PSE	Transferencia Bancaria
Bancolombia	Transferencia Bancaria
Nequi	Transferencia Bancaria
Daviplata	Transferencia Bancaria

México (MX)

Método	Descripción
Transferencia Bancaria	Pago a Clabe de un solo uso

Notas Importantes

Caché

La respuesta está cacheada por 1 hora para mejorar el rendimiento.

Caso de uso

Usa este endpoint para mostrar a tus usuarios los métodos de pago disponibles en cada país antes de crear un Payment Link.

• La disponibilidad de métodos de pago puede variar según la configuración del comercio