BINANCE SAPI · C2C

API para Obtener Método de Pago por ID

Consulta los datos exactos de configuración, números de cuenta, códigos de enrutamiento bancario e información del titular para un método de pago vinculado específico mediante su identificador único.

ENDPOINT

GET /sapi/v1/c2c/paymentMethod/getPayMethodById

Autenticación USER_DATA / SIGNED

Grupo API C2C / Payment Method

Método GET

Respuesta JSON

Descripción General

Este endpoint obtiene los parámetros de configuración completos de un método de pago individual vinculado por el usuario en Binance P2P. Al enviar el identificador único de configuración de pago (id), los desarrolladores y sistemas automatizados pueden inspeccionar las cuentas bancarias del beneficiario, identificadores de dinero móvil, tipos de método de pago y nombres de titular verificados.

Mesas de trading automatizado, sistemas ERP para comerciantes y motores de bots emplean este endpoint para validar previamente los detalles de pago antes de publicar nuevos anuncios o al cotejar instrucciones entrantes de liquidación fiduciaria.

Parámetros de la Solicitud

Parámetros aceptados en la URL (Query string) y encabezados HTTP.

Parámetro	Ubicación	Tipo	Requerido	Descripción
`clientType`	Header	STRING	Requerido	Tipo de dispositivo o cliente que realiza la petición (por ejemplo, `WEB`, `APP` o `WEB_MOBILE`).
`id`	Query	INT64	Requerido	Identificador único de la configuración del método de pago (`payId`).
`x-gray-env`	Header	STRING	Opcional	Identificador de entorno utilizado internamente para pruebas o despliegues controlados (gray testing).
`x-trace-id`	Header	STRING	Opcional	Identificador de trazabilidad generado por el cliente para el seguimiento y depuración de la solicitud.
`x-user-id`	Header	STRING	Opcional	Identificador de usuario objetivo si se requiere validar el contexto de la cuenta.

Construcción de Parámetros en Solicitudes GET

El identificador del método de pago debe adjuntarse directamente a la URL del endpoint como parámetro de consulta (por ejemplo, ?id=12345678), acompañado de los parámetros obligatorios de firma criptográfica y marca de tiempo.

Ejemplo de Solicitud

Ejemplo de solicitud GET mediante cURL para consultar los detalles del método de pago por ID.

cURL BASH

curl -X GET \
'https://api.binance.com/sapi/v1/c2c/paymentMethod/getPayMethodById?id=12345678' \
-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": "JPMorgan Chase",
            "branch": "New York Main"
        },
        "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).
`message`	STRING	Mensaje descriptivo del resultado o confirmación de la petición.
`data.id`	INT64	Identificador único de la configuración del método de pago.
`data.payType`	STRING	Identificador interno del canal de pago (por ejemplo, `BANK`, `REVOLUT`, `WISE`).
`data.payMethodName`	STRING	Nombre legible y visible del método de pago en la plataforma.
`data.realName`	STRING	Nombre verificado del titular de la cuenta bancaria o billetera.
`data.fields`	OBJECT	Objeto clave-valor con los atributos específicos del medio de pago (como número de cuenta, CLABE, IBAN o nombre del banco).
`data.status`	INT	Estado del método de pago (`1`: Activo/Habilitado, `0`: Inactivo/Deshabilitado).
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para consultar la configuración de un método de pago.

01 Obtener ID Consigue el identificador (payId) desde la lista de métodos o de tu anuncio.

02 Enviar Solicitud Llama vía GET a /sapi/v1/c2c/paymentMethod/getPayMethodById?id={id}.

03 Analizar Datos Extrae número de cuenta, campos bancarios y estado activo.

04 Validar Liquidación Confirma que los datos coincidan con las cuentas bancarias de destino.

Casos de Uso Comunes

Validación Previa al Publicar Anuncios

Asegura que un payId seleccionado se encuentre activo y posea datos bancarios válidos antes de vincularlo a un anuncio nuevo.

Enrutamiento Automatizado de Transferencias

Extrae dinámicamente números de cuenta y códigos de banco para ordenar transferencias salientes desde sistemas de tesorería propios.

Auditoría de Configuraciones Comerciales

Comprueba la integridad de los datos de pago y sus estados operativos a lo largo de flotas de cuentas de comerciantes automatizados.