Binance API / SAPI / C2C
BINANCE SAPI · C2C

API de Lista de Métodos de Pago Válidos

Consulta el directorio global completo de métodos de pago, canales bancarios y billeteras electrónicas regionales admitidos en el mercado peer-to-peer (C2C/P2P) de Binance.

ENDPOINT
POST /sapi/v1/c2c/paymentMethod/listAll
Autenticación USER_DATA / SIGNED
Grupo API C2C / Payment Method
Método POST
Respuesta JSON (Paginado)

Descripción General

Este endpoint proporciona acceso al registro maestro de todos los métodos de pago válidos y admitidos en los mercados fiat de Binance C2C (P2P). Devuelve las definiciones técnicas de cada canal de pago, incluyendo identificadores del sistema (identifier / payType), nombres comerciales localizados, esquemas de campos obligatorios requeridos y compatibilidad monetaria.

Aplicaciones para mesas de dinero, plataformas de arbitraje multidivisa y software para comerciantes consultan este catálogo para alimentar selectores dinámicos en sus interfaces y garantizar que los datos bancarios ingresados cumplan con las estructuras exigidas por Binance.

01

Parámetros de la Solicitud

Parámetros de encabezado (Header) aceptados por el endpoint.

EncabezadoTipoRequeridoDescripción
clientTypeSTRINGRequeridoTipo de dispositivo o cliente que realiza la consulta (por ejemplo, WEB, APP o WEB_MOBILE).
x-gray-envSTRINGOpcionalIdentificador de entorno utilizado internamente para pruebas o despliegues controlados (gray testing).
x-trace-idSTRINGOpcionalIdentificador de trazabilidad generado por el cliente para el seguimiento y depuración de la solicitud.
x-user-idSTRINGOpcionalIdentificador de usuario objetivo si se requiere evaluar el contexto de la cuenta.
i

Petición POST sin Cuerpo (Body)

La consulta del catálogo general se ejecuta mediante una llamada HTTP POST con el cuerpo vacío. Asegúrate de incluir el encabezado obligatorio clientType junto con los parámetros requeridos de firma (signature y timestamp).

02

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL para consultar el catálogo global de métodos de pago.

cURL BASH
curl -X POST \
'https://api.binance.com/sapi/v1/c2c/paymentMethod/listAll' \
-H 'clientType: WEB'

03

Respuesta

Ejemplo de respuesta devuelta tras consultar exitosamente el catálogo de pagos.

RESPONSE 200 OK
{
    "code": "000000",
    "message": "success",
    "data": {
        "total": 350,
        "data": [
            {
                "identifier": "BANK",
                "name": "Bank Transfer",
                "tradeType": "BOTH",
                "fields": [
                    {
                        "fieldName": "account",
                        "fieldTitle": "Bank Account Number",
                        "required": true
                    },
                    {
                        "fieldName": "bankName",
                        "fieldTitle": "Bank Name",
                        "required": true
                    },
                    {
                        "fieldName": "branch",
                        "fieldTitle": "Branch Info",
                        "required": false
                    }
                ]
            },
            {
                "identifier": "REVOLUT",
                "name": "Revolut",
                "tradeType": "BOTH",
                "fields": [
                    {
                        "fieldName": "revtag",
                        "fieldTitle": "Revtag / Phone Number",
                        "required": true
                    }
                ]
            }
        ]
    },
    "success": true
}

Campos de la Respuesta

CampoTipoDescripción
codeSTRINGCódigo de respuesta estándar de Binance ("000000" indica éxito).
data.totalINTCantidad total de canales y métodos de pago admitidos en el catálogo global.
data.dataARRAYColección de objetos con las especificaciones técnicas de cada método de pago.
data.data[].identifierSTRINGIdentificador único del tipo de pago (por ejemplo, BANK, REVOLUT, ZELLE).
data.data[].nameSTRINGNombre público estandarizado del método o sistema de pago.
data.data[].fieldsARRAYArreglo que describe los campos de entrada requeridos, títulos visibles y obligatoriedad para configurar el canal.
successBOOLEANIndica el resultado general de la ejecución de la petición.

04

Cómo Funciona

Flujo de trabajo para consultar los métodos de pago globales disponibles.

01 Fijar Encabezados Incluye clientType y credenciales firmadas en los headers.
 
02 Enviar Solicitud Llama vía POST a /sapi/v1/c2c/paymentMethod/listAll.
 
03 Analizar Esquemas Extrae los canales soportados y la estructura de campos requeridos.
 
04 Sincronizar Interfaz Renderiza dinámicamente los medios de pago en paneles de comerciantes.

Casos de Uso Comunes

Generación Dinámica de Formularios

Construye formularios interactivos en aplicaciones web o móviles que renderizan automáticamente los campos bancarios requeridos según las especificaciones de Binance.

Sincronización del Catálogo Local

Almacena en caché el catálogo global para cotejar los identificadores de pago de Binance con pasarelas de pago y sistemas de liquidación internos.

Expansión a Nuevas Regiones y Monedas

Detecta de forma programática nuevos bancos locales, billeteras electrónicas o redes de dinero móvil agregadas para divisas internacionales.

Endpoints Relacionados de Binance API

💬
Telegram WhatsApp