Query the settlement status

Supefina settlement status request address

The name of the environment	URL
SandBox	POST https://api.supefina.tech/api/supefina/transactions/search-order
Formal environment	POST https://api.supefina.net/api/supefina/transactions/search-order

Request parameters

Key	Value
Content-Type	application/json

Request body

Variable name	The name of the field	Required	type	description	Example values
merId	Merchant code	Yes	String	Merchant ID Merchant ID acquisition path: Supefina Merchant Background - Merchant Management - Basic Information - Merchant ID
countryId	Country number	Yes	String	Country number Reference: Dictionary table - country number Mexico: MEX	MEX
merOrderNo	Merchant order number	Yes	String	Merchant order number
supefinaOrderId	Supefina order number	Yes	String	Supefina order number
nonceStr	Random strings	Yes	String	Random strings The length cannot exceed 32 bits
sign	signature	Yes	String	signature For details, please refer to: Signature algorithm

Sample request

{
	"merId":"8201247036390625",
	"countryId":"COL",
	"merOrderNo":"123456",
	"supefinaOrderId":"20240423000201024a1d9915bb145",
	"sign":"R9d1Enp0XUS5YMwv0EP$blm9mWTWwyoB",
	"nonceStr":"123"
}

Response parameters

Variable name	type	description
code	String	Response coding For details, see Response Status Code
msg	String	Response Information
data	Object	Response data
multiple	Boolean	Whether there are multiple pieces of data Yes: true No: false
target	Array	Array of targets
settleStatus	String	Settlement status 01: Settled 02: Unsettled
supefinaOrderId	String	Supefina order number
merOrderId	String	Merchant order number
merId	String	Merchant code
transactionType	String	The type of transaction 01:Payin 02:Payout
amount	String	The amount of the order
realityAmount	String	Paid-in amount
fee	String	Advance handling fee will be charged
realityFee	String	Actual handling fee
successTime	Date	The time at which the transaction was successful
identifier	String	Payment reference identifier

Sample response

{
    "code": 200,
    "msg": "success",
    "data": {
        "multiple": false,
        "target": [
            {
                "settleStatus": "00",
                "supefinaOrderId": "20240423000201024a1d9915bb145",
                "merOrderId": "123456",
                "merId": "8201247036390625",
                "transactionType": "02",
                "amount": "3001.00",
                "realityAmount": "3001.00",
                "fee": "304.10",
                "realityFee": "304.10",
                "successTime": "2024-04-24 01:21:17",
                "identifier": ""
            }
        ]
    }
}