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 Carat 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 Carat:

Sigla na Samsung Pay	Bandeira
VI	Visa
MC	MasterCard

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 Carat#

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://{{url}}/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.

Importante:
Diferentemente de outras carteiras digitais, o pagamento com Samsung Pay não deverá solicitar o CVV na confirmação do mesmo. Caberá ao lojista efetuar negociação com as redes adquirentes (Acquirers) para realização dos pagamentos sem a obrigatoriedade do código de segurança;
Porém, mesmo que as Redes adquirentes permitam transações sem este código (CVV2), não há garantias que o Emissor (Instituição Bancária) aceite uma transação desta forma (sem o código de segurança).

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 Carat. 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.

Home