Pular para conteúdo

Conversor de Moedas | Deeplink

A nova funcionalidade Conversão de moedas permite que portadores de cartões internacionais realizem pagamentos na moeda original de seus países. De acordo com as exigências da bandeira do cartão, é necessário que o comprovante contenha informações sobre a conversão da moeda realizada pelo cartão.

Atenção:

Mesmo que seu aplicativo utilize Responsabilidade de Impressão o comprovante será impresso pelo app de Pagamento. Isso pode causar um problema de duplicidade na impressão consequentemente um consumo alto de bobinas. Para resolver essa situação estamos disponibilizando duas possibilidades abaixo:

Opção 1 - Não imprimir quando for Conversão de Moedas

A fim de facilitar a implantação da funcionalidade, adicionamos o campo receiptAlreadyPrinted na resposta da integração deeplink para notificar o app parceiro, que este não deve imprimir os dados de comprovante(mesmo que utilize Responsabilidade de Impressão)

    data.getBooleanExtra("receiptAlreadyPrinted", false);

Opção 2 - Imprimir todos os dados relativos à Conversão de Moedas

Seu app pode receber os dados completos, contendo os dados da conversão, consequentemente será responsável pela impressão completa dos dados recebidos. Para isto, seu aplicativo deve utilizar o deeplink Pagamento v3 enviando o novo campo abaixo no request. Notificando o App de Pagamento, que seu app já "conhece" todos os novos campos de Conversão de moeda, e consegue imprimi-los.

    bundle.putBoolean("dccReceiptImplemented", true);

Dados obrigatórios em Conversão de Moeda

Comprovante Estabelecimento

Campo Tipo Valor Fixo Descrição
mandatory_ec_fields.dcc_ec_fields.messageToEc String "VOCÊ RECEBEU UMA COMISSÃO POR UTILIZAR O CONVERSOR DE MOEDAS, CONFIRA NO EXTRATO DE VENDAS NO APLICATIVO GETNET BRASIL OU NO PORTAL MINHA CONTA." Mensagem ao estabelecimento quando houve conversão de moeda

Comprovante Cliente - Portador do Cartão

Campo Nome no comprovante Tipo Template Fixo Descrição
mandatory_client_fields.dcc_client_fields.totalAmount Total Amount String 50,00 BRL Valor total cobrado na transação
mandatory_client_fields.dcc_client_fields.exchangeRate Exchange Rate String 1 BRL = 0.203100 USD (ARS/CHF/EUR...) Valor da cotação utilizada
mandatory_client_fields.dcc_client_fields.markup Markup String 1,3% Valor do Markup em reais
mandatory_client_fields.dcc_client_fields.amountCharged Amount Charged String 10.20 USD (ARS/CHF/EUR...) Valor total cobrado do portador
mandatory_client_fields.dcc_client_fields.messageToClient String I HAVE BEEN OFFERED A CHOICE OF CURRENCIES AND AGREED TO PAY IN UNITED STATES DOLLAR(USD) DYNAMIC CURRENCY CONVERSION (DCC) IS OFFERED BY GETNET Mensagem para informar o portador do cartão

Exemplo JSON de resposta

automationSlip={
  "mandatory_all_receipts_fields": {
    "amount": "R$ 32,00",
    "authorizationCode": "006734",
    "brand": "MASTERCARD",
    "cardLastDigits": "4283",
    "city": "PORTO ALEGRE",
    "ecDocument": "69.600.609/0001-06",
    "ecName": "CREDENCIAMENTO ELO V",
    "ecNumber": "000000051523906",
    "getnetLogo": "", //Logo da Getnet em formato String Base64
    "dateTime": "09/11/21 17:27:05",
    "letterTypeTransaction": "C",
    "nsu": "000000443",
    "terminal": "10001593",
    "version": "V0A57.0004.0021"
  },
  "mandatory_client_fields": {
    "clientBody": "CREDITO A VISTA \nVALOR: 10,00",
    "receiptTypeClient": "Via Cliente",
    "dcc_client_fields": {
      "totalAmount": "50,00 BRL",
      "exchangeRate": "1 BRL = 0.203100 USD",
      "markup": "1,2%",
      "amountCharged": "10.20 USD",
      "messageToClient": "I HAVE BEEN OFFERED A CHOICE OF CURRENCIES AND AGREED TO PAY IN UNITED STATES DOLLAR(USD) DYNAMIC CURRENCY CONVERSION (DCC) IS OFFERED BY GETNET"
    }
  },
  "mandatory_ec_fields": {
    "aid": "A0000000041010",
    "arqc": "3D084907A1C169DC",
    "ecBody": "CREDITO A VISTA \nVALOR: 10,00\n \nTRANSACAO APROVADA MEDIANTE\n USO DE SENHA PESSOAL",
    "nsuLocal": "000204",
    "receiptTypeEc": "Via Estabelecimento",
    "dcc_ec_fields": {
      "messageToEcDcc":"VOCÊ RECEBEU UM CASHBACK POR UTILIZAR O CONVERSOR DE MOEDAS, CONFIRA NO EXTRATO DE VENDAS NO APLICATIVO GETNET BRASIL OU NO PORTAL MINHA CONTA."
    }
  }
}

Exemplo de comprovantes

Comprovante cliente Comprovante Estabelecimento
Comprovante-Cliente
Visualização do XML no Android Studio
Comprovante-Estabelecimento
Visualização do XML no Android Studio
Comprovante-Impresso-Cliente
Comprovante impresso no POS Digital
Comprovante-Impresso-Estabelecimento
Comprovante impresso no POS Digital
Comprovante antigo cliente Comprovante antigo Estabelecimento
Comprovante-Cliente
Visualização do XML no Android Studio
Comprovante-Estabelecimento
Visualização do XML no Android Studio