Código QR e Payment instantâneo
Na jornada QR Code & Instant Payment, a Yuno apresenta um único código QR que cobra o cliente imediatamente e o inscreve em todos os pagamentos recorrentes futuros em uma única etapa. Quando o cliente escaneia o QR, seu aplicativo bancário processa a primeira parcela e, simultaneamente, captura seu consentimento para cobranças automáticas subsequentes, eliminando a necessidade de aprovações adicionais ou entrada manual.
Após a verificação e o pagamento iniciais, cada solicitação subsequente é enviada pelo comerciante via Yuno e validada automaticamente pelo banco do cliente em relação ao consentimento original, garantindo transferências rápidas e confiáveis sem interação adicional com o cliente. Esse fluxo maximiza a conversão e simplifica o gerenciamento de assinaturas, combinando a inscrição e o pagamento em uma única ação do usuário.
Etapa 1: Primeiro pagamento e criação da assinatura
Para iniciar o fluxo, você deve começar com um Pagamento do Pix que também configura a assinatura. Isso gera um código QR ou uma tela de redirecionamento para que o cliente autorize a recorrência. Uma vez paga, a assinatura é criada e um subscription_id é retornado.
Você pode definir a frequência, a janela de disponibilidade e o tipo de valor (fixo ou variável) como parte da carga útil da assinatura.
| Campos para assinaturas | Descrição |
|---|---|
| Frequência | Defina a frequência com que as cobranças de assinatura ocorrerão, seja diária, semanal ou mensal, especificando o valor que precisa ser cobrado para o próximo ciclo de faturamento. |
| Disponibilidade | As datas de início e término da assinatura. |
| Valor | Defina o valor que você usará para pagamentos futuros da assinatura. Pode ser FIXED com um valor mínimo definido, ou VARIABLE sem um valor definido para pagamentos futuros. |
Conforme mencionado anteriormente, tenha em mente que as informações definidas na criação da assinatura restringirão as datas e os valores a serem usados para pagamentos futuros.
{
"amount": {
"value": "100",
"currency": "BRL"
},
"payment_method": {
"type": "PIX_AUTOMATIC"
},
"subscription": {
"frequency": {
"type": "MONTH",
"value": 1
},
"availability": {
"start_at": "2025-05-23T20:17:30.277678Z",
"finish_at": "2027-05-23T20:17:30.277678Z"
},
"amount": {
"value": "100",
"currency": "BRL",
"type": "FIXED" // or "VARIABLE"
}
}Depois que o pagamento inicial for confirmado, o cliente terá uma assinatura ativa e você poderá começar a programar cobranças futuras.
Etapa 2: Pagamentos futuros
Conforme definido pelo banco central, os pagamentos devem ser criados no máximo 2 dias antes da data de faturamento programada e no mínimo 10 dias após a criação da assinatura. Use o subscription_id para identificar a recorrência na criação do pagamento.
| Campos para pagamentos futuros | |
|---|---|
subscription_id | ID da assinatura obtida na primeira etapa. |
| data_de_faturamento | Ao especificar o objeto billing_date, o comerciante pode definir a lógica por trás da data exata para a cobrança da assinatura. |
"workflow": "DIRECT",
"amount": {
"value": "100",
"currency": "BRL"
},
"payment_method": {
"type": "PIX_AUTOMATIC",
},
"subscription": {
"id": "cab9f0fe-2428-419b-8f9d-4b5efee8c1c8",
"billing_date": {
"type": "DAY",
"day": 14
}
}Se um pagamento recorrente falhar, ele poderá ser tentado novamente usando uma nova solicitação de pagamento. As novas tentativas devem ocorrer dentro de 7 dias da data de cobrança original e são limitadas a 3 tentativas por ciclo.
Atualizado há 3 meses