Atualizações para agosto de 2024

Explore os aprimoramentos mais recentes do objeto Payments, incluindo IDs de contratos de assinatura, suporte à conversão de moedas e a capacidade de cancelar ou reembolsar pagamentos. Confira as atualizações abaixo.

Foram feitas algumas atualizações no objeto Pagamentos. Verifique as atualizações abaixo.

ID do contrato de assinatura
Pagamentos com transações
Pagamentos com conversão de moeda
Código ISO e mensagem
Cancelar ou reembolsar um pagamento

Contrato de assinatura ID

Para determinados mercados (MX, por exemplo) e processadores de pagamento, quando um pagamento relacionado à assinatura é feito, a ID do contrato com o cliente precisa ser especificada na solicitação de pagamento para garantir o processamento correto. Para facilitar isso, ativamos a opção subscription_agreement_id dentro do campo stored_credentials permitindo que você compartilhe o acordo feito com o cliente.

"payment_method": {
        "type":"CARD",
        "vaulted_token": "eb8caa17-6407-457b-960e-125d8d7a90c1",
        "detail": {
           "card": {
               "stored_credentials":{
                  "reason":"CARD_ON_FILE",
                  "usage": "USED",
                  "subscription_agreement_id":"AA0001"
              }
           }
        }
    }

Consulte a documentação do guia de credenciais armazenadas para obter mais detalhes.

Pagamentos com transações

Os pagamentos podem ser feitos para diferentes métodos de pagamento, como contas bancárias e até mesmo cartões, dependendo do provedor. Para pagamentos a um método de pagamento com cartão em que o comerciante não tem as informações do cartão de crédito (por não estar em conformidade com o PCI), a Yuno permite que eles enviem o pagamento se o cartão tiver sido usado anteriormente em um pagamento. Isso é chamado de "Pagamento referenciado".

Para poder usar isso, você precisará primeiro cobrar o cliente usando uma de nossas soluções compatíveis com PCI (qualquer SDK Yuno) e, em seguida, fazer um pagamento indicando a transação original onde podemos encontrar as informações do cartão de crédito.

"withdrawal_method": {
    "type": "STP_PAYOUT",
    "provider_id": "STP",
    "original_transaction_id":"9104911d-5df9-429e-8488-ad41abea1a4b"
  }

Consulte a documentação sobre pagamentos para obter mais detalhes.

Pagamentos com conversão de moeda

O serviço de conversão de moeda da Yuno permite que você liquide pagamentos na sua moeda e na moeda do seu cliente. A conversão de moedas é o processo de conversão de uma moeda em outra. Ela envolve o uso de taxas de câmbio para determinar o valor equivalente na moeda de destino.

O comerciante pode utilizar o serviço de conversão de moeda de um provedor externo e enviar as informações correspondentes diretamente no pagamento no Yuno. Para utilizar este serviço, entre em contato com seu gerente de conta técnico para garantir que as informações estejam configuradas corretamente, uma vez que a taxa de conversão de moeda deve ser fornecida por um serviço externo do provedor. Exemplo:

"amount": {
        "currency": "COP",
        "value": 5000, 
        "currency_conversion": {
            "provider_currency_conversion_id": "AAA01SADOIAJSDLAKSJM",
            "cardholder_currency": "ARS",
            "cardholder_amount": 1146.55    
        }
    }

Consulte a documentação sobre conversão de moedas para obter mais detalhes.

Código ISO e mensagem

Adicionamos dois novos campos ao Payment object chamado iso8583_response_code e iso8583_response_message. Ambos os campos representam a resposta direta do provedor em relação ao padrão internacional para mensagens de intercâmbio originadas por cartões de transações financeiras (ISO 8583).

"transactions": {
        "id": "4450529a-a5f9-4856-9ba9-21aed302e209",
        "type": "PURCHASE",
        "status": "SUCCEEDED",
        "category": "CARD",
        "amount": 5000.00,
        "provider_id": "ADYEN",
        "payment_method": {
              ...
        },
        "response_code": "SUCCEEDED",
        "response_message": "Transaction successful",
        "reason": null,
        "description": "SUCCEDED",
        "merchant_reference": "1234",
        "provider_data": {
            "id": "ADYEN",
            "transaction_id": "FLX4WSXF7SFZDV65",
            "account_id": "YunoPayments_Sandbox_TEST",
            "status": "Authorised",
            "status_detail": "Authorised",
            "response_message": null,
            "response_code": null,
            "iso8583_response_code": "05",
            "iso8583_response_message": "Approved or completed successfully"

Se os códigos da ABECS (Associação Brasileira das Empresas de Cartões e Serviços) forem retornados pelo provedor de pagamentos, eles serão exibidos nos campos iso_code_response_code e message.

Verifique o objeto de pagamentos para obter mais detalhes.

Cancelar ou reembolsar um pagamento

Adicionamos um nova funcionalidade para a API de pagamentos, onde você pode cancelar ou reembolsar um pagamento apenas fornecendo o payment id, ao contrário do serviço existente onde o transaction_id é necessário. Por favor, verifique o pagamentos Consulte a referência da API para obter mais detalhes.