PIX

（payProduct=24）

Proceso de pago

1、El usuario realiza un pedido en el sitio del comerciante eligiendo el pago por PIX;

2、El comerciante envía una solicitud de pago PIX a Supefina;

3、Supefina devuelve la información del URL de pago PIX;

4、El comerciante muestra esa URL de pago al usuario;

5、El usuario abre la URL, muestra el código QR y sigue las instrucciones de la página para pagar;

6、El pago se realiza con éxito;

7、Supefina notifica al comerciante que el pedido fue exitoso.

Video de pago

7MB

Payment video-PIX.mp4

URL de solicitud de la pasarela de pago

Entorno	URL
SandBox	POST https://api.supefina.tech/api/supefina/transactions/payin
Producción	POST https://api.supefina.net/api/supefina/transactions/payin

Parámetros de solicitud

Encabezado de solicitud

Key	Value
Content-Type	application/json

Cuerpo de solicitud

Nombre de variable	Tipo	Obligatorio	Descripción
callbackUrl	String	No	Dirección de callback Consultar la instrucción de notificación de callback
countryId	String	Sí	Código del país Referencia：Tabla de diccionario-Código del país Brasil：BRA
currency	String	Sí	Moneda Referencia：Tabla de diccionario-Moneda eal brasilReño：BRL
customerPhone	String	No	Número de teléfono
customerEmail	String	Sí	Correo electrónico del usuario
customerIdentification	String	No	Número de identificación del usuario
customerName	String	Sí	Nombre del usuario
description	String	Sí	Descripción del pedido: No puede contener símbolos especiales
expireTimeL	Long	No	Tiempo de expiración Unidad: segundos Rango: 300-172800 segundos.
merId	String	Sí	ID del comerciante Ruta para obtener el ID del comerciante: Panel de comerciante Supefina - Gestión de comerciantes - Información básica - ID del comerciante
merOrderNo	String	Sí	Número de pedido del comerciante
nonceStr	String	Sí	Cadena aleatoria La longitud no puede exceder 32 caracteres
orderAmount	String	Sí	Monto del pedido Se admiten dos decimales; 3 >= orderAmount <= 50000.
payProduct	String	Sí	Tipo de pago PIX：24
sign	String	Sí	Firma Referencia específica: algoritmo de firma

Ejemplo de solicitud

{
    "callbackUrl": "https://test.com",
    "countryId": "BRA",
    "currency": "BRL",
    "customerEmail": "[email protected]",
    "customerIdentification": "123456789-09",
    "customerName": "test name",
    "description": "test description",
    "merId": "8202759583060992",
    "merOrderNo": "1234777f35edb1965949059290",
    "nonceStr": "mFI99d699u",
    "orderAmount": "10.00",
    "payProduct": "24",
    "sign": "226736F20763B930BEBFDABE342F7538"
}

Parámetros de respuesta

Nombre de variable	Tipo	Descripción
code	String	Código de respuesta Referencia específica: Códigos de estado de respuesta
data	Object	Datos de respuesta
amount	BigDecimal	Monto del pedido
channelName		Nombre del canal
fee	BigDecimal	Comisión anticipada
merCode	String	ID de comerciante
merOrderNo	String	Número de pedido del comerciante
referenceCode		Código QR de pago
supefinaOrderNo	String	Número del pedido de Supefina
transactionStatus	String	Estado del pedido. Este estado indica si la solicitud fue exitosa, sin relación con el estado real de la transacción. 00: Pedido exitoso; 04: Pedido fallido.
url	String	Enlace de la transacción
msg	String	Mensaje de respuesta

Ejemplo de respuesta

{
    "code": "200",
    "data": {
        "amount": 10.00,
        "channelName": "brpix",
        "fee": 0.04,
        "merCode": "8202759583060992",
        "merOrderNo": "1234777f35edb1965949059290",
        "referenceCode": "00020126920014br.gov.bcb.pix2570qrcodes.sulcredi.coop.br/v2/v3/at/97036e99-cb37-4432-a63a-aee049738d115204000053039865802BR5908ARK PAGO6009SAO PAULO62070503***63046E32",
        "supefinaOrderNo": "20240513050101498940f64291983",
        "transactionStatus": "00",
        "url": "https://h5.supefina.net/supefina?token="
    },
    "msg": "success "
}

Notificación de callback

Método de envío: POST

Nombre de variable	Tipo	Descripción
amount	String	Monto del pedido
countryId	String	Código del país
customerName	String	Nombre del pagador
fee	String	Comisión anticipada
merId	String	ID de comerciante
merOrderId	String	Número de pedido del comerciante
msg	String	Mensaje
nonceStr	String	Cadena aleatoria
payerIdNumber	String	CPF del pagador
payerName	String	Nombre del pagador
realityAmount	String	Monto recibido
realityFee	String	Comisión recibida
reference	String	Identificador
sign	String	Firma
status	String	Estado de la transacción Referencia específica: Tabla de diccionario - Estado del pedido de transacción
successTime	Date	Tiempo de éxito de la transacción
supefinaOrderId	String	Número del pedido de Supefina
transactionType	String	Tipo de transacción 01：Payin 02：Payout
identifier	String	Referencia de pago Clabe

Ejemplo de notificación de callback

{
    "amount": "10.00",
    "countryId": "BRA",
    "customerName": "test name",
    "fee": "0.04",
    "identifier": "706180968985601627",
    "merId": "8202759583060992",
    "merOrderId": "1234777f35edb1965949059290",
    "nonceStr": "7f00fe52-15c7-40e0-a881-6d98a5",
    "payerIdNumber": "15169686463",
    "payerName": "pay person name",
    "realityAmount": "10.00",
    "realityFee": "0.04",
    "reference": "E228964319624061706672exq6TZQQ99",
    "sign": "37AB65F3A0C4743651005CBB1C4639F4",
    "status": "01",
    "successTime": 1718604452000,
    "supefinaOrderId": "20240513050101498940f64291983",
    "transactionType": "01"
}

Respuesta de notificación de callback

Después de que el comerciante reciba correctamente la notificación de callback, debe devolver la cadena especificada: SUCCESS. Si no se devuelve o se devuelve otro contenido, se considerará que la notificación ha fallado. Por ejemplo:

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