TarsPay_EN

Query balance

POST

/api/balanceInfo

Request

Header Params

X-API-KEY

string

required

The public key applied by the merchant backend

Example:

02106af2a085fbfc6d1bb49f485205fcdfcc79a4ddb1913c72a271fedd24c2d7fe

X-API-NONCE

string

required

System timestamp accurate to milliseconds

Example:

1702279880267

X-API-SIGNATURE

string

required

signature

Example:

304502207a4a88a5b0def29b9dbbf8563112d090c0e0b793ff6a5c57fe9d4fd1254d8ecf022100ff63c279f5926069fa1d161598e8d3249cb90e9d728e88e514352cdae6feff72

Body Params application/json

mchNo

string

Merchant ID

required

Example

{
    "mchNo": "M1688443086"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/balanceInfo' \
--header 'X-API-KEY: 02106af2a085fbfc6d1bb49f485205fcdfcc79a4ddb1913c72a271fedd24c2d7fe' \
--header 'X-API-NONCE: 1702279880267' \
--header 'X-API-SIGNATURE: 304502207a4a88a5b0def29b9dbbf8563112d090c0e0b793ff6a5c57fe9d4fd1254d8ecf022100ff63c279f5926069fa1d161598e8d3249cb90e9d728e88e514352cdae6feff72' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mchNo": "M1688443086"
}'

Responses

🟢200成功

application/json

Body

code

integer

required

data

object

required

machNo

string

Merchant ID

required

availableAmount

string

Available Balance

required

frozenAmount

string

Freeze Balance

required

msg

string

required

Example

{
    "code": 0,
    "data": {
        "availableAmount": "11713783",
        "frozenAmount": "0",
        "mchNo": "M1688443086"
    },
    "msg": "SUCCESS"
}

withdraw query payment certificate

Callback notification interface (customized by the merchant)