Atualizações para novembro de 2024

Descubra as atualizações mais recentes do Yuno, incluindo detalhes de expiração do cartão, pagamentos divididos aprimorados, recibos de reembolso, itens de assinatura e pagamentos com tokens protegidos. Confira as atualizações abaixo.

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

Detalhes sobre a validade do cartão
Destinatários para pagamentos divididos no Marketplace
Recibos para transações canceladas
Itens para assinaturas
Pagamentos com tokens armazenados em cofre

Detalhes sobre a validade do cartão

Adicionamos mais dois campos à resposta de pagamento, chamados expiration_year e expiration_monthOs campos (dentro de cada transação.card_data) especificam os detalhes de validade do cartão usado para efetuar o pagamento, fornecendo as informações sem que seja necessário acessar o método de pagamento.

[...]
"card_data": {
                    "holder_name": "Paco",
                    "iin": "48710499",
                    "lfd": "9910",
                    "number_length": 16,
                    "security_code_length": 3,
                    "brand": "VISA",
                    "issuer_name": "BNP PARIBAS FORTIS",
                    "issuer_code": null,
                    "country_code": "BE",
                    "category": "CLASSIC",
                    "type": "DEBIT",
                    "three_d_secure": {
                        "version": null,
                        "electronic_commerce_indicator": null,
                        "cryptogram": null,
                        "transaction_id": null,
                        "directory_server_transaction_id": null,
                        "pares_status": null,
                        "acs_id": null
                    },
                    "fingerprint": "71000db4-f8e7-4ea0-a2cc-9d9ebb76a955",
                    "expiration_month": 3,
                    "expiration_year": 30
[...]

Destinatários para o Split Marketplace

Adicionamos um novo recurso às solicitações do mercado de pagamentos divididos chamado Destinatários. Caso você utilize mais de um provedor de pagamentos para os pagamentos divididos, recomendamos usar o objeto destinatários, pois ele permite definir mais de um provedor para cada destinatário.

Criação de destinatários

{
    "account_id": "{{account-code}}",
    "providers": [{
        "id": "PAGARME",
        "recipient_id": "XXXXXXXX"
    }],
    "external_id": "AAAA05",
    "national_entity": "INDIVIDUAL",
    "first_name": "John",
    "last_name": "Doe",
    "legal_name": "Arcos dorados S.A.",
    "email": "[email protected]",
    "country": "CO",
    "document": {
        "document_number": "1093333333",
        "document_type": "CC"
    },
    "phone": {
        "country_code": "57",
        "number": "3132450765"
    },
    "address": {
        "address_line_1": "Calle 34 # 56 - 78",
        "address_line_2": "Apartamento 502, Torre I",
        "city": "Bogota",
        "country": "CO",
        "state": "Cundinamarca",
        "zip_code": "111111"
    }
}

Envio de um pagamento

[...],
"amount": {
        "currency": "BRL",
        "value": 1000
    },
"split_marketplace": [
                {
                    "amount": {
                        "currency": "BRL",
                        "value": 500
                    },
                    "recipient_id": "09d8bad7-4efe-47e2-b9ee-f4028460bab1",
                    "type": "PURCHASE"
                },
                {
                    "amount": {
                        "currency": "BRL",
                        "value": 500
                    },
                    "recipient_id": "d94e02c1-cc47-4e60-a20a-2b17fe58992d",
                    "type": "PURCHASE"
                }
            ],
[...]

Para obter mais informações, consulte a solicitação de mercado de pagamentos parcelados na seção de guias da API.

Recibos para transações de reembolso

Adicionamos um novo recurso às solicitações de reembolso chamado Recibos. Esse recurso permite que você obtenha um recibo para cada transação de reembolso feita no Yuno. Como o Yuno não executa o reembolso aos adquirentes, esse recibo representa a execução da solicitação ao provedor para reembolsar a compra feita anteriormente.

{
  "description": "Duplicate",
  "reason": "REQUESTED_BY_CUSTOMER",
  "merchant_reference": "AAB01-432245",
  "response_additional_data": 
    	{
          "receipt": true,
          "receipt_language": "ES"
        }
}

Depois que o REEMBOLSO for criado, você poderá fazer um receber o pagamento para encontrar o recibo criado no campo "receipt_url" no payment.transaction objeto.

Para obter mais informações, consulte a solicitação de reembolso na seção de referência da API.

Itens para assinaturas

Adicionamos um novo recurso ao recurso Assinatura chamado Dados adicionais. Agora, o Yuno permite que você especifique informações sobre os itens relacionados à assinatura para que possamos enviar essas informações aos provedores.

{
  "name": "Test Subscription",
  "description": "Subscription Test",
  "merchant_reference": "subscription-ref-merchant-AA01",
  "account_id": "{{account-code}}",
  "country": "BR",
  "additional_data": {
    "order": {
      "items": [
        {
          "category": "art",
          "id": "AA01",
          "name": "Test item",
          "quantity": 1,
          "unit_amount": 10
        }
      ]
    }
  },
  "amount": {
    "currency": "BRL",
    "value": 1500
  },
  "frequency": {
    "type": "MONTH",
    "value": 1
  },
  "billing_cycles": {
    "total": 12
  },
  "customer_payer": {
    "id": "a1d3b664-e32a-4508-9da1-9ede3e62a60c"
  },
  "payment_method": {
    "type": "CARD",
    "vaulted_token": "d4aa3586-def2-4705-b7cd-fe064bb764e6"
  },
}
'

Para obter mais informações, consulte a seção de referência da API de assinaturas.

Pagamentos com tokens armazenados em cofre

Adicionamos um novo recurso ao produto Pagamentos, que permite criar solicitações diretamente para um cartão de crédito/débito cadastrado no Yuno, se for compatível com o provedor.

[...],
"withdrawal_method": {
    "type": "CARD",
    "provider_id": "UNLIMINT",
    "vaulted_token":"[the payment method vaulted token]"
  }
[...]

Para mais informações, consulte:

Seção do guia de inscrição para o processo de inscrição.
Seção de referência da API de pagamentos para criação de pagamentos.