Samsung Pay

Como Funciona

Quando o comprador clica no botão de pagamento do Samsung Pay, são exibidas as formas de pagamentos salvas na conta do Samsung Pay. O comprador pode selecionar rapidamente a forma de pagamento desejada e opcionalmente preencher informações adicionais da compra. Após esta interação com a Samsung Pay, estes mesmos dados serão enviados/processados pelo e-SiTef para efetuar o fluxo de pagamento.

Para mais informações sobre o fluxo de pagamento com wallets, consulte a página de Visão Geral

Dados cadastrais necessários

Em casos de integração via API REST, será necessário que o lojista utilize o Service ID da Software Express junto a Samsung. Para obter o Service ID de ambiente de homologação/produção entre em contato com nossa equipe de suporte.

Bandeiras suportadas

As seguintes redes de cartões disponíveis na Samsung Pay (Brasil) são suportadas pelo e-SiTef:

Sigla na Samsung PayBandeira
VIVisa
MCMasterCard

Pagamento/Pré-Autorização REST

Na modalidade de Pagamento ou Pré-Autorização o lojista deve realizar a primeira parte da integração com a Samsung Pay (todas as etapas de integração até a obtenção do Reference ID). por favor, entre em contato com o suporta da Samsung para mais detalhes.

O Reference ID deve então ser repassado para as nossas interfaces REST.

Envie os dados para o e-SiTef

Ao concluir a a primeira parte da integração com Samsung Pay, você terá em mãos o Reference ID.

Esse dado deve ser repassado pelo campo card.wallet_transaction_id da interface.


curl -X POST \
  https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/v1/payments/<NIT> \
  --header "Content-Type: application/json" \
  --header "merchant_id: <MERCHANT_ID>" \
  --header "merchant_key: <MERCHANT_KEY>" \
  --data-binary '{
    "authorizer_id": "410",
    "card": {
        "wallet_transaction_id": "exemploReferenceId"
    }
}'

No exemplo acima, foi definido no campo authorizer_id com o valor 410, que corresponde selecionar a Samsung Pay como forma de pagamento; e foi definido no campo wallet_transaction_id com o valor do Reference ID da Samsung Pay . Uma execução bem-sucedida do comando acima retornará um JSON semelhante à abaixo.

{
   "code":"0",
   "message":"OK. Transaction successful.",
   "payment":{
      "authorizer_code":"000",
      "authorizer_message":"Transacao OK",
      "status":"CON",
      "nit":"<NIT>",
      "order_id":"13034649671",
      "customer_receipt":"====CUPOM COMPRADOR====",
      "merchant_receipt":"====CUPOM ESTABELECIMENTO====",
      "authorizer_id":"410",
      "acquirer_id":"1005",
      "acquirer_name":"Redecard",
      "authorizer_date":"28/02/2020T08:57",
      "authorization_number":"132030",
      "merchant_usn":"13034649671",
      "esitef_usn":"170713097340300",
      "sitef_usn":"132030",
      "host_usn":"999132030",
      "payment_date":"13/07/2017T15:52",
      "amount":"1000",
      "payment_type":"C",
      "issuer":"2",
      "authorizer_merchant_id":"<MERCHANT_ID>"
   }
}

Pagamento/Pré-Autorização HTML

Para utilizar o Samsung Pay com o pagamento/pré-autorização HTML, entre em contato com um membro de nossa equipe de suporte para realizar a configuração necessária. É possível determinar quais bandeiras serão aceitas no Samsung Pay para a integração HTML.

Captura de Pré-Autorização REST e Cancelamento REST/via Portal

O Samsung Pay não permite que um mesmo Reference ID seja utilizado mais de uma vez. Por conta disso operações de duas etapas como Pagamento/Cancelamento, Pré-Autorização/Captura exigem que o cartão do pagador seja armazenado no e-SiTef. O armazenamento pala interface HTML pode ser realizado junto com o pagamento/pre-autorização seguindo a documentação de Pagamento com armazenamento de cartão ou pela interface REST, como descrito no capítulo abaixo.

Armazenamento REST

É possível realizar o armazenamento de cartão utilizando o Reference ID da Samsung Pay. Entre em contato com a nossa equipe de suporte para realizar as configurações necessárias para possibilitar este armazenamento.

O armazenamento de cartão REST funciona como se fosse armazenar um cartão qualquer, porém com os seguintes cuidados:

  • Ao invés de enviar os número do cartão, envie o campo wallet_transaction_id com o conteúdo do Reference ID.
  • O envio do campo authorizer_id deve ser '410' (Samsung Pay).

Para maiores detalhes, veja aqui.

← MasterpassApple Pay →