Pesquisar

Are you looking for test card numbers?

Would you like to contact support?

Point-of-sale icon

Adyen Giving para terminais

Permita que seus clientes doem para instituições de caridade quando fizerem uma compra na loja.

  Mais informações

Saiba mais sobre a Adyen Giving em adyen.com.

Com a Adyen Giving, você pode dar aos seus clientes a opção de doar para uma instituição de caridade depois que eles fizerem uma compra em sua loja.

As doações podem ser feitas usando muitos métodos populares de pagamento, e são liquidadas diretamente na conta bancária da instituição.

O Adyen Giving é suportado em integrações com API de Terminais, integração Classic e também com nossa solução não integrada. Tudo o que você precisa é de um dos seguintes terminais de pagamento:

  • e285
  • M400
  • P400 Plus
  • V240m Plus
  • V400c Plus
  • V400m

Antes que sua instituição beneficente possa receber doações, elas precisam ser integradas e precisaremos configurar o Adyen Giving para sua merchant account. O terminal deverá então solicitar uma doação:

  • Automaticamente após cada pagamento. Isso é possível com todas as integrações e também com a solução não integrada.
  • Através da sua solicitação de pagamento, para que você tenha controle sobre quando solicitar uma doação. Isso é possível com uma integração da API de terminais.

Métodos de pagamento suportados

As doações em loja são suportadas pelos seguintes métodos de pagamento:

Como funciona

O terminal não solicita uma doação quando está offline ou após um pagamento com cartão vale presente.

Independentemente da doação ser solicitada automaticamente após cada pagamento por meio de uma solicitação de pagamento, o fluxo para a doação é o que segue:

  1. Você inicia um pagamento para as mercadorias que seu cliente está comprando.

  2. O cliente apresenta seu cartão no terminal e conclui o pagamento.
    Em uma integração com API de terminais ou em uma integração Classic, você recebe a resposta à sua solicitação de pagamento.

  3. O terminal mostra que o pagamento foi Aprovado e apresenta as opções de doação para caridade.

       
  4. Se o cliente optar por doar, o terminal inicia uma nova transação (a transação de doação) pelo valor que o cliente selecionou.
    Em uma integração com API de terminais ou em uma integração Classic, você não receberá uma resposta para esta transação.

  5. O cliente apresenta seu cartão e completa a transação de doação.
    A doação é encaminhada para a instituição de caridade e liquidada diretamente em sua conta bancária.

O cliente verá duas cobranças separadas no extrato bancário, uma para o pagamento, e outra para a doação.

Integração com Adyen Giving

Antes que sua instituição beneficente possa receber doações, elas precisam ser integrada à Adyen Giving.

Você deve abordar a instituição de caridade escolhida e obter o consentimento deles antes de iniciar o processo de integração.

Para iniciar o processo de integração, entre em contato com o gerente de sua conta na Adyen ou com nossa POS Support Team. Eles irão lidar com a integração junto com a caridade. A instituição de caridade terá sua própria conta na Customer Area, onde poderá ter uma visão geral das doações e lidar com quaisquer reembolsos e estornos

Configurar a Adyen Giving

Quando você entrar em contato conosco para iniciar o processo de integração de sua instituição de caridade, informe-nos também:

  • Se você deseja solicitar automaticamente uma doação após cada pagamento ou se deseja solicitar uma doação por meio de uma solicitação de pagamento. O último será possível com uma integração da API de terminais.
  • Quais opções de doação você deseja mostrar no visor do terminal.

Opções de doação

As opções de doação incluem:

  • A opção Not now. Isso permite que os clientes ignorem a doação.
  • • Até três outras opções. Isso pode incluir valores fixos de doações e a opção Custom, que permite que os clientes insiram um valor de sua própria escolha.

Solicite uma doação através do sua solicitação de pagamento

Com uma integração da API de terminais, você pode usar a opção tender AskGiving em sua solicitação de pagamento para controlar quando uma doação será solicitada ao cliente.

Para garantir que o terminal solicite uma doação ao cliente após o pagamento:

  • Faça uma solicitção PaymentRequest que contenha um campo SaletoAcquirerData com uma opção tender AskGiving especificada em um dos seguintes formatos:

    • Opção 1: Um objeto JSON {"tenderOption": "AskGiving"} convertido em uma sequência codificada Base64::
      "SaleToAcquirerData": "eyJ0ZW5kZXJPcHRpb24iOiAiQXNrR2l2aW5nIn0="

    • Opção 2: tenderOption=AskGiving:
      "SaleToAcquirerData": "tenderOption=AskGiving"

    O formato que você usa aqui também será o formato di AdditionalResponse que você recebe.

    Se houverem mais opções tender e outros elementos de dados que você precisa enviar no campo SaleToAcquirerData, consulte Adicionais informações a um pagamento para obter instruções.

    {
        "SaleToPOIRequest": {
            "PaymentRequest": {
                "SaleData": {
                    "SaleTransactionID": {
                        "TransactionID": "997",
                        "TimeStamp": "2020-12-02T16:16:48.000Z"
                    },
                    "SaleToAcquirerData": "tenderOption=AskGiving"
                },
                "PaymentTransaction": {
                    "AmountsReq": {
                        "Currency": "EUR",
                        "RequestedAmount": 155.75
                    }
                }
            },
            "MessageHeader": {
                "ProtocolVersion": "3.0",
                "MessageClass": "Service",
                "MessageCategory": "Payment",
                "MessageType": "Request",
                "ServiceID": "0110123015",
                "SaleID": "POSSystemID12345",
                "POIID": "M400-260193322"
            }
        }
    }
    String serviceID = "YOUR_UNIQUE_ATTEMPT_ID";
        String saleID = "YOUR_CASH_REGISTER_ID";
        String POIID = "YOUR_TERMINAL_ID";
        String transactionID = "YOUR_UNIQUE_TRANSACTION_ID";
    
        SaleToPOIRequest saleToPOIRequest = new SaleToPOIRequest();
        MessageHeader messageHeader = new MessageHeader();
        messageHeader.setProtocolVersion("3.0");
        messageHeader.setMessageClass( MessageClassType.SERVICE );
        messageHeader.setMessageCategory( MessageCategoryType.PAYMENT );
        messageHeader.setMessageType( MessageType.REQUEST );
        messageHeader.setServiceID(serviceID);
        messageHeader.setSaleID(saleID);
        messageHeader.setPOIID(POIID);
        saleToPOIRequest.setMessageHeader(messageHeader);
    
        PaymentRequest paymentRequest = new PaymentRequest();
        SaleData saleData = new SaleData();
        TransactionIdentification saleTransactionID = new TransactionIdentification();
        saleTransactionID.setTransactionID(transactionID);
        saleTransactionID.setTimeStamp(DatatypeFactory.newInstance().newXMLGregorianCalendar(new GregorianCalendar()));
        saleData.setSaleTransactionID(saleTransactionID);
        saleData.setSaleToAcquirerData("tenderOption=AskGiving");
        paymentRequest.setSaleData(saleData);
    
        PaymentTransaction paymentTransaction = new PaymentTransaction();
        AmountsReq amountsReq = new AmountsReq();
        amountsReq.setCurrency("EUR");
        amountsReq.setRequestedAmount( BigDecimal.valueOf(155.75) );
        paymentTransaction.setAmountsReq(amountsReq);
        paymentRequest.setPaymentTransaction(paymentTransaction);
        saleToPOIRequest.setPaymentRequest(paymentRequest);
        terminalAPIRequest.setSaleToPOIRequest(saleToPOIRequest);

    Observe que a resposta do pagamento é exatamente igual à resposta que você recebe por uma solicitação de pagamento sem a opção tender AskGiving. A caixa registradora não recebe informações sobre a resposta do cliente ao pedido de doação, porque a transação de doação é iniciada pelo terminal após a conlcusão da transação de pagamento.

Veja também