BINANCE SAPI · C2C

API de Métodos de Pago por Usuario

Consulta la lista completa de todos los métodos de pago configurados y vinculados, cuentas bancarias y billeteras digitales asociadas a la cuenta del usuario autenticado.

ENDPOINT

GET /sapi/v1/c2c/paymentMethod/getPayMethodByUserId

Autenticación USER_DATA / SIGNED

Grupo API C2C / Payment Method

Método GET

Respuesta JSON (Array)

Descripción General

Este endpoint obtiene todos los canales de pago configurados por el usuario para operar dentro del mercado Binance C2C (P2P). Devuelve un arreglo con las configuraciones de pago vinculadas, incluyendo sus identificadores únicos (id / payId), nombres de canal comercial, titulares verificados, campos bancarios específicos y estados de activación vigentes.

Software de trading algorítmico, terminales de comerciantes y bots de publicación dinámica de anuncios invocan este endpoint durante sus rutinas de inicio para cargar los métodos seleccionables y determinar los identificadores payId requeridos al crear anuncios.

Parámetros de la Solicitud

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

Encabezado	Tipo	Requerido	Descripción
`clientType`	STRING	Requerido	Tipo de dispositivo o cliente que realiza la petición (por ejemplo, `WEB`, `APP` o `WEB_MOBILE`).
`x-gray-env`	STRING	Opcional	Identificador de entorno utilizado internamente para pruebas o despliegues controlados (gray testing).
`x-trace-id`	STRING	Opcional	Identificador de trazabilidad generado por el cliente para el seguimiento y depuración de la solicitud.
`x-user-id`	STRING	Opcional	Identificador de usuario objetivo si se requiere validar el contexto de la cuenta.

Solicitud GET sin Parámetros de URL

Este endpoint no requiere variables adicionales en la URL ni cuerpo JSON. Únicamente debes incluir el encabezado obligatorio clientType junto con los parámetros estándar de firma (signature y timestamp) en las cabeceras HTTP.

Ejemplo de Solicitud

Ejemplo de solicitud GET mediante cURL para listar todos los métodos de pago del usuario.

cURL BASH

curl -X GET \
'https://api.binance.com/sapi/v1/c2c/paymentMethod/getPayMethodByUserId' \
-H 'clientType: WEB'

Respuesta

Ejemplo de respuesta devuelta tras una consulta exitosa.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": [
        {
            "id": 12345678,
            "payType": "BANK",
            "payMethodName": "Bank Transfer",
            "realName": "John Doe",
            "fields": {
                "account": "9876543210",
                "bankName": "Chase Bank",
                "branch": "New York"
            },
            "status": 1
        },
        {
            "id": 87654321,
            "payType": "REVOLUT",
            "payMethodName": "Revolut",
            "realName": "John Doe",
            "fields": {
                "revtag": "@johndoe",
                "phone": "+123456789"
            },
            "status": 1
        }
    ],
    "success": true
}

Campos de la Respuesta

Campo	Tipo	Descripción
`code`	STRING	Código de respuesta estándar de Binance (`"000000"` indica éxito).
`data`	ARRAY	Lista de objetos con las configuraciones de pago vinculadas a la cuenta.
`data[].id`	INT64	Identificador único de la configuración de pago (utilizado como `payId` en órdenes y anuncios).
`data[].payType`	STRING	Identificador interno del tipo de medio de pago (por ejemplo, `BANK`, `REVOLUT` o `WISE`).
`data[].payMethodName`	STRING	Nombre comercial visible del método de pago.
`data[].realName`	STRING	Nombre legal verificado del titular de la cuenta bancaria o billetera.
`data[].fields`	OBJECT	Diccionario clave-valor con datos específicos de la cuenta (como número de cuenta, CLABE, IBAN o teléfono).
`data[].status`	INT	Estado de activación (`1`: Habilitado/Activo, `0`: Inhabilitado/Inactivo).
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para listar los métodos de pago vinculados al usuario.

01 Fijar Encabezados Incluye clientType y credenciales firmadas USER_DATA.

02 Enviar Solicitud Llama vía GET a /sapi/v1/c2c/paymentMethod/getPayMethodByUserId.

03 Procesar Métodos Extrae los id (payId) y canales habilitados.

04 Vincular en Anuncios Utiliza los payId para publicar anuncios o despachar pagos en bots.

Casos de Uso Comunes

Creación Dinámica de Anuncios

Recupera de forma automatizada los IDs de métodos activos para asociarlos a nuevos anuncios de compra o venta creados por bots.

Auditoría de Canales de Cobro

Inspecciona periódicamente todas las cuentas bancarias vinculadas para comprobar que sigan activas y con datos actualizados.

Selectores de Pago en Frontends

Alimenta listas desplegables de métodos de pago en paneles web personalizados y aplicaciones de gestión para comerciantes.