Atualizações para maio de 2025

Houve algumas atualizações sobre a Yuno. Confira as atualizações abaixo.

Registro de Token de rede
Data de faturamento da assinatura
Data de expiração
Geolocalização
Cancelar para pagamentos APM
Webhooks de assinaturas

Registro de Token de rede

Estamos introduzindo uma atualização para otimizar a forma como tokens de rede são gerados no Yuno.
Quando o recurso de tokens de rede estiver ativado, o Yuno continuará a gerar tokens de rede para todos os cartões registrados e armazenados com segurança em nosso Vault. Essa abordagem está totalmente alinhada com a forma como a tokenização de rede deve funcionar, conforme definido pela Visa e pela Mastercard após a validação do cartão, garantindo melhor desempenho, segurança e confiabilidade em transações recorrentes e futuras.
Os cartões não armazenados na Yuno - como os cartões de uso único - são naturalmente excluídos desse processo, uma vez que a tokenização de rede não é aplicável nesses casos.

Para obter mais informações sobre como Tokens de rede funcionam, consulte a documentação sobre tokens de rede na seção de guias.

Data de faturamento da assinatura

Adicionamos um novo recurso ao Assinatura recurso chamado Billing date. Ao especificar a billing_date o comerciante pode definir a lógica por trás da data exata para o faturamento da assinatura. Mutuamente exclusivo com o objeto de frequência.

Campo	Tipo	Descrição
data_de_faturamento	estrutura	A estrutura da data de faturamento
tipo	número	O tipo de billing_date que a assinatura terá no tempo. PREPAID, POSTDATE, DAY. Se não for definida, a data de criação do plano será definida por padrão.
dia	número	O dia do mês para cobrar a assinatura se o tipo estiver definido como DAY. Sempre 1 por padrão.

Para obter mais informações, consulte a documentação sobre assinaturas na seção de guias.

Data de expiração

Adicionamos um novo recurso à API de pagamentos, que permite visualizar e especificar a data de vencimento de um método de pagamento assíncrono para o pagamento.

[...], 
"payment_method": {
        "vaulted_token": "",
        "type": "NU_PAY",
        "vault_on_success": false,
        "token": "",
        "parent_payment_method_type": null,
        "payment_method_detail": {
            "wallet": {
               [...]
                "expirates_at": "2025-05-14T15:06:48.383418Z"
            }
        }

📘
Disponível somente quando o provedor associado ao pagamento o suportar. Fique à vontade para entrar em contato com o gerente técnico da sua conta para esclarecer outras dúvidas.

Consulte a referência da API de pagamentos para obter mais informações.

Geolocalização

Adicionamos um novo recurso à API de pagamentos, que permite que você defina a geolocalização do seu cliente para o pagamento.

[...], 
 "customer_payer": {
        "id": "b080db73-b12d-4710-a604-d659bce26f01",
        "merchant_customer_id": "example00234",
        "first_name": "Pepito",
        "last_name": "Perez",
        "gender": "M",
        "date_of_birth": "1990-02-28",
        "email": "[email protected]",
        "nationality": "BR",
        [..]
        "shipping_address": {
            "address_line_1": "Calle 34 # 56 - 78",
            "address_line_2": "Apartamento 502, Torre I",
            "country": "CO",
            "state": "Cundinamarca",
            "city": "Bogota",
            "zip_code": "111111",
            "neighborhood": null
        },
        "geolocation": {
            "latitude": "-34.4720",
            "longitude": "-58.5300"
        }
[...]

Consulte a referência da API de pagamentos para obter mais informações.

Cancelar para pagamentos APM

Adicionamos um novo recurso à API de pagamentos, que permite cancelar um PENDING criado usando um método de pagamento alternativo. Anteriormente, isso era restrito a transações com cartão.

Esse recurso só está disponível quando o provedor associado ao pagamento o suporta. Fique à vontade para entrar em contato com o gerente técnico da sua conta para obter mais informações, caso precise usá-lo.

Consulte o endpoint de cancelamento de pagamentos para obter mais informações.

Assinaturas para Webhooks

Adicionamos um novo recurso ao Yuno, que permite que você defina um webhook_url para receber atualizações sobre suas assinaturas. Você só precisará definir a url na seção Developers do painel para começar a recebê-las.

Dependendo do tipo de evento, você receberá um tipo diferente de webhook e evento.

Para obter mais informações sobre como funcionam os webhooks, como eles são configurados no Yuno e ver exemplos, consulte a documentação dos webhooks na seção de guias.