Transaction inquiries

The address of the request

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

Request parameters

Key	Value
Content-Type	application/json

Request body

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

Sample request

{
    "countryId": "MEX",
    "merId": "8501088932494545",
    "merOrderNo": "arcus123",
    "supefinaOrderId": "202404290301009a6bb592c072449",
    "nonceStr": "D30FDC30597446FD95B792AC1E1A0AF5",
    "sign": "R9d1Enp0XUS5YMwv0EP$blm9mWTWwyoB"
}

Response parameters

Variable name	type	description
code	String	Response coding For details, see Response Status Code
msg	String	Response Information
data	Object	Response data
transactionStatus	String	Transaction status Dictionary table – the status of trading orders
supefinaOrderId	String	Supefina order number
merOrderId	String	Merchant order number
merId	String	Merchant ID
transactionType	String	The type of transaction 01:Payin 02:Payout
amount	BigDecimal	The amount of the order
realityAmount	BigDecimal	Paid-in amount
fee	BigDecimal	Advance handling fee will be charged
realityFee	BigDecimal	Actual handling fee
successTime	Date	The time at which the transaction was successful
identifier	String	Payment reference identifier
stampTime	String	Transaction success time (timestamp format, accurate to the second)
clave	String	Central Bank Flow Identifier
errorMsg	String	Reason for failure (transaction failed and order failed status returned)

Sample response

{
    "code": "200",
    "msg": "success ",
    "data": {
        "transactionStatus": "01",
        "supefinaOrderId": "202404290301009a6bb592c072449",
        "merOrderId": "arcus123",
        "merId": "8501088932494545",
        "transactionType": "01",
        "amount": "35.55",
        "realityAmount": "35.00",
        "fee": "1.00",
        "realityFee": "1.00",
        "successTime": "2024-04-29 08:44:26",
        "identifier": "706180220387407414",
        "stampTime": 1714380266000,
        "clave": "TP162841Rep1"
    }
}