Skip to main content

You (Unico) Gateway

You Gateway Integration#

You is Unico's Open Finance solution that combines PIX instant payments with real-time biometric identity verification.

How It Works#

  1. Customer initiates a PIX payment in your checkout
  2. Tuna generates the PIX QR code and simultaneously creates a You verification session
  3. Customer completes identity verification via You's interface
  4. Upon successful verification, the PIX payment is confirmed

API Response#

The Init endpoint response includes a digitalWalletInfo.you object alongside the standard pixInfo. See the "Pix with OpenFinance/You" response example in the API reference.

{
"pixInfo": {
"qrContent": "00020101021126580014br.gov.bcb.pix...",
"qrCopyPaste": "00020101021126580014br.gov.bcb.pix...",
"qrImage": "https://..."
},
"digitalWalletInfo": {
"you": {
"processId": "19d7cc39-7e3d-4ba8-bc61-4ddd00a05537",
"token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
"link": "https://idcash.unico.io/invoice?id=19d7cc39-7e3d-4ba8-bc61-4ddd00a05537"
}
}
}

Initializing the You SDK#

Pass processId and token from the response to the You SDK:

const you = new You({
options: {
id: response.methods[0].digitalWalletInfo.you.processId,
token: response.methods[0].digitalWalletInfo.you.token
}
});
you.start();
FieldYou SDK paramDescription
processIdoptions.idUnique identifier for the verification process
tokenoptions.tokenJWT token for the verification session
link—Direct URL to You verification interface (alternative to SDK)

PIX Behavior Is Unchanged#

You works on top of a standard Tuna PIX payment. The PIX QR code generated in the same operation is the one that gets paid — You adds identity verification on top of it, but does not replace or alter the PIX itself.

This means:

  • Everything your integration already does to check PIX payment status is still valid. The Status endpoint, webhooks, and any polling logic you use today continue to work exactly the same way.
  • If the customer chooses to pay via You, they use the same QR code — You receives the QR data directly from Tuna and its Open Finance infrastructure takes care of paying it, without the customer needing to scan anything. The resulting PIX transaction is indistinguishable from a regular PIX at the payment level.
  • If You verification is skipped or fails, the PIX QR code remains valid and the customer can still pay it directly. The payment flow degrades gracefully to a plain PIX.

In short: You is an optional identity layer. The PIX underneath it behaves exactly as documented in the PIX integration guide.

Resources#