BINANCE SAPI · C2C

Get Payment Method by UserId API

Retrieve a complete list of all configured and bound payment methods, bank accounts, and digital wallets associated with the authenticated user account.

ENDPOINT

GET /sapi/v1/c2c/paymentMethod/getPayMethodByUserId

Authentication USER_DATA / SIGNED

API Group C2C / Payment Method

Method GET

Response JSON (Array)

Overview

This endpoint fetches all user-configured payment channels available for Binance C2C (P2P) trading. It returns an array of payment method configurations, including unique identifiers (id / payId), payment channel names, verified beneficiary account names, bank identifiers, and current activation statuses.

Automated trading software, merchant consoles, and dynamic ad placement bots invoke this endpoint during initialization routines to populate selectable payment methods and determine valid payId values for advertisement creation.

Request Parameters

Header parameters accepted by the endpoint.

Header	Type	Required	Description
`clientType`	STRING	Required	Client Device Type initiating the request (e.g., `WEB`, `APP`, `WEB_MOBILE`).
`x-gray-env`	STRING	Optional	Environment flag identifier used for internal gray/stage testing.
`x-trace-id`	STRING	Optional	Custom client trace ID for request lifecycle tracking and debugging.
`x-user-id`	STRING	Optional	Target user identifier for context validation.

Parameterless GET Request

This endpoint does not require URL query strings or JSON request bodies. Simply pass the mandatory clientType header in the HTTP request.

Request Example

Example GET request using cURL to list all user payment methods.

cURL BASH

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

Response

Example response returned on successful query execution.

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
}

Response Fields

Field	Type	Description
`code`	STRING	Standard Binance status code (`"000000"` indicates success).
`data`	ARRAY	List of user payment configuration objects.
`data[].id`	INT64	Unique payment method configuration ID (used as `payId` in order matching and ad management).
`data[].payType`	STRING	Internal identifier for the payment type (e.g., `BANK`, `REVOLUT`, `WISE`).
`data[].payMethodName`	STRING	User-facing label for the payment channel.
`data[].realName`	STRING	Verified legal account holder name.
`data[].fields`	OBJECT	Key-value dictionary containing account details, IBAN, bank name, or digital handle.
`data[].status`	INT	Activation status flag (`1`: Active, `0`: Inactive/Disabled).
`success`	BOOLEAN	Indicates overall request execution result.

How It Works

Workflow for listing all user-configured payment channels.

01 Set Headers Attach clientType and user-data credentials.

02 Send GET Request Call /sapi/v1/c2c/paymentMethod/getPayMethodByUserId.

03 Parse Method IDs Extract id list and payment channel types.

04 Bind to Ads & Orders Use retrieved IDs to publish ads or configure bot payouts.

Common Use Cases

Dynamic Ad Creation

Populate active payment method IDs automatically when publishing new buy/sell advertisements via bot scripts.

Merchant Account Auditing

Inspect all bound bank accounts and payment channels to verify that details remain current and active.

UI Payment Selectors

Populate payment option dropdowns in custom web portals and mobile merchant management interfaces.

← Previous Endpoint List All Of Valid Payment Methods API Next Endpoint → Get Payment Method by ID API

Related Binance API Endpoints

📚

Part of the Spot Arbitrage Guide

This article is part of our complete learning guide covering professional cross-exchange cryptocurrency arbitrage.

Explore the Spot Arbitrage Guide →

📚

Part of the Binance P2P Automation Guide

This article is part of our complete learning guide covering Binance P2P automation, merchant tools, and automated trading.

Explore the Binance P2P Automation Guide →

Novelty