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 assinaturasDescrição
FrequênciaDefina 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.
DisponibilidadeAs datas de início e término da assinatura.
ValorDefina 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_idID da assinatura obtida na primeira etapa.
data_de_faturamentoAo 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.