Debin

（payProduct=29）

Payment Process

1. The user places an order on the merchant's website/app and selects Debin to pay;

2. The merchant initiates a Debin payment request to Supefina;

3. Supefina returns the URL address of Debin payment;

4. The merchant will open the address on the user's side;

5. The user shall verify and pay according to the prompts on the page;

6. The user pays successfully;

7. Supefina will notify the merchant of the payment success information.

The address of the request

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

Request parameters

Request header

Key	Value
Content-Type	application/json

Request body

Variable name	type	Required	description
countryId	String	Yes	Country number Reference: Dictionary table - country number Argentina: ARG
merId	String	Yes	Merchant ID Merchant ID acquisition path: Supefina Merchant Background - Merchant Management - Basic Information - Merchant ID
payProduct	String	Yes	Payment type Debin：29
currency	String	Yes	Currency Reference: Dictionary Table - Currency Argentine peso: ARS
merOrderNo	String	Yes	Merchant order number
orderAmount	String	Yes	The amount of the order Only integers are supported
customerEmail	String	Yes	The user's email address The email username cannot be a number (for example, [email protected]) and the same email address cannot have more than 20 payment requests per day.
customerName	String	Yes	User's name
customerPhone	String	Yes	User phone
customerIdentificationType	String	Yes	The type of user ID 00: Identity Card (DNI) 02: Tax Identification Number (CUIT)
customerIdentification	String	Yes	The user's ID number
checkOut	Boolean	Yes	Pass true
nonceStr	String	Yes	Random strings The length cannot exceed 32 bits
sign	String	Yes	signature For details, please refer to: Signature algorithm
description	String	No	description It cannot contain special symbols and should not exceed 200 characters in length
callbackUrl	String	No	Callback address For details, see Notification Callbacks
returnUrl	String	No	The address to return after the payment is complete
expireTimeL	Long	No	Expiration time Unit: seconds; Default: 84960

Sample request

{
    "countryId": "ARG",
    "currency": "ARS",
    "orderAmount": 100,
    "payProduct": "29",
    "merId": "81027695265247",
    "merOrderNo": "20241113013257171",
    "sign": "xxxxxxxx",
    "nonceStr": "test",
    "customerEmail": "[email protected]",
    "customerName": "test name",
    "customerPhone": "123456789",
    "customerIdentificationType": "02",
    "customerIdentification": "11111111-1",
    "checkOut": true,
    "description": "test",
    "callbackUrl": "http://127.0.0.1:8080/test",
    "expireTimeL": 3600
}

Response parameters

Variable name	type	description
code	String	Response coding For details, see Response Status Code
msg	String	Response Information
data	Object	Response data
merCode	String	Merchant ID
merOrderNo	String	Merchant order number
url	String	Cashier address

Sample response

{
    "code": "200",
    "msg": "success ",
    "data": {
        "merCode": "test",
        "merOrderNo": "test",
        "url": "test"
    }
}

Callback notifications

Submission method：POST

Variable name	type	description
amount	String	The amount of the order
countryId	String	Country number
customerName	String	User's name
fee	String	Advance handling fee will be charged
identifier	String	Payment Reference Clabe
merId	String	Merchant code
merOrderId	String	Merchant order number
msg	String	Information
nonceStr	String	Random strings The length cannot exceed 32 bits
realityAmount	String	Paid-in amount
realityFee	String	Actual handling fee
sign	String	signature
status	String	Transaction status For details, please refer to: Dictionary Table - Trading Order Status
successTime	Date	The time at which the transaction was successful
supefinaOrderId	String	Supefina order number
transactionType	String	The type of transaction 01：Payin 02：Payout
payerIdNumber	String	The payer's ID number
payerIdType	String	The type of payer's document
payerName	String	Name of the payer
payerAccountNo	String	Payer account number
payerAccountType	String	Payer account type

An example of a callback notification

{
    "amount": "230.00",
    "countryId": "ECU",
    "customerName": "Test Name",
    "fee": "6.90",
    "identifier": "90911988431",
    "merId": "8202980903390150",
    "merOrderId": "17922853818122896811753697281175369728",
    "nonceStr": "935111b9-968e-4b3d-9036-fd1acf",
    "realityAmount": "230",
    "realityFee": "6.90",
    "sign": "69DF96903B85CD1408BD6849C62254C0",
    "status": "01",
    "successTime": 1716149235000,
    "supefinaOrderId": "202405190101010696298b1ca1141",
    "transactionType": "01"
}

Callback notification response

After the merchant successfully receives the callback, it needs to return the specified string synchronously: SUCCESS does not return or returns other content by default, and the notification fails As：

public String test(){
	return "SUCCESS";
}