Samsung Pay

O Samsung Pay é uma carteira digital que possibilita a realização de pagamentos em lojas físicas, lojas virtuais e aplicativos, por meio de cartões de crédito e débito cadastrados na conta Samsung e em dispositivos compatíveis.

Pré-requisito
Para usar o Samsung Pay, a loja deve estar cadastrada e intregrada ao Samsung Pay. O cadastro deve ser concluído seguindo todas as etapas exigidas pela Samsung, caso contrário não será possível a integração com a API.

Exemplo de Requisição

Ambiente	Método	Endpoint
Sandbox	post	`https://apisandbox.braspag.com.br/v2/sales/`
Produção	post	`https://api.braspag.com.br/v2/sales/`

*Exemplo de transação com os campos de e-wallet

{
  "merchantOrderId": "123456789",
  "customer": {
    "name": "Aline de Souza",
    "identity": "58154781050",
    "identityType": "CPF",
    "email": "[email protected]",
    "birthdate": "1990-01-01",
    "ipAddress": "192.168.0.1",
    "address": {
      "street": "Rua das Rosas",
      "number": "123",
      "complement": "apartamento 101",
      "zipCode": "12345987",
      "city": "São Paulo",
      "state": "SP",
      "country": "BR",
      "district": "Jardim das Flores"
    },
    "deliveryAddress": {
      "street": "Rua das Rosas",
      "number": "123",
      "complement": "apartamento 101",
      "zipCode": "12345987",
      "city": "São Paulo",
      "state": "SP",
      "country": "BR",
      "district": "Jardim das Flores"
   },
   "Payment":{
      "Type":"CreditCard",
      "Amount":1,
      "Provider":"Cielo",
      "Installments":1,
      "Currency":"BRL",
      "Wallet":{
         "Type":"SamsungPay",
"WalletKey":"eyJhbGciOiJSU0ExXzUiLCJraWQiOiIvam1iMU9PL2hHdFRVSWxHNFpxY2VYclVEbmFOUFV1ZUR5M2FWeHBzYXVRPSIsInR5cCI6IkpPU0UiLCJjaGFubmVsU2VjdXJpdHlDb250ZXh0IjoiUlNBX1BLSSIsImVuYyI6IkExMjhHQ00ifQ.cCsGbqgFdzVb1jhXNR--gApzoXH-fdafddfaBo_utsmDN_DuGm69Kk2_nh6txa7ML9PCI59LFfOMniAf7ZwoZUBDCY7Oh8kx3wsZ0kxNBwfyLBCMEYzET0qcIYxePezQpkNcaZ4oogmdNSpYY-KbZGMcWpo1DKhWphDVp0lZcLxA6Q25K78e5AtarR5whN4HUAkurQ.CFjWpHkAVoLCG8q0.NcsTuauebemJXmos_mLMTyLhEHL-p5Wv6J88WkgzyjAt_DW7laiPMYw2sqRXkOiMJLwhifRzbSp8ZgJBM25IX05dKKSS4XfFjJQQjOBHw6PYtEF5pUDMLHML3jcddCrX07abfef_DuP41PqOQYsjwesLZ8XsRjR0TH4diOZ_GQop8_oawjRIo9eJr9Wbtho0h8kAzHYpfuhamOPT718EaGAY6SSrR7t6nBkzGNkrKAmHkC7aRwe.AbZG53wRqgF0XRG3wUK_UQ"
      }
   }
}

curl
--request POST "https://apisandbox.braspag.com.br/v2/sales/"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--header "MerchantKey: 0123456789012345678901234567890123456789"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
  "merchantOrderId": "123456789",
  "customer": {
    "name": "Aline de Souza",
    "identity": "58154781050",
    "identityType": "CPF",
    "email": "[email protected]",
    "birthdate": "1990-01-01",
    "ipAddress": "192.168.0.1",
    "address": {
      "street": "Rua das Rosas",
      "number": "123",
      "complement": "apartamento 101",
      "zipCode": "12345987",
      "city": "São Paulo",
      "state": "SP",
      "country": "BR",
      "district": "Jardim das Flores"
    },
    "deliveryAddress": {
      "street": "Rua das Rosas",
      "number": "123",
      "complement": "apartamento 101",
      "zipCode": "12345987",
      "city": "São Paulo",
      "state": "SP",
      "country": "BR",
      "district": "Jardim das Flores"
   },
   "Payment":{
      "Type":"CreditCard",
      "Amount":1,
      "Provider":"Cielo",
      "Installments":1,
      "Currency":"BRL",
      "Wallet":{
         "Type":"SamsungPay",
         "WalletKey":"y
LBCMEYzET0qcIYxePezQpkNcaZ4oogmdNSpYY-KbZGMcWpo1DKhWphDVp0lZcLxA6Q25K78e5AtarR5whN4HUAkurQ.CFjWpHkAVoLCG8q0.NcsTuauebemJXmos_mLMTyLhEHL-
p5Wv6J88WkgzyjAt_DW7laiPMYw2sqRXkOiMJLwhifRzbSp8ZgJBM25IX05dKKSS4XfFjJQQjOBHw6PYtEF5pUDMLHML3jcddCrX07abfef_DuP41PqOQYsjwesLZ8XsRj-
R0TH4diOZ_GQop8_oawjRIo9eJr9Wbtho0h8kAzHYpfuhamOPT718EaGAY6SSrR7t6nBkzGNkrKAmHkC7aRwe.AbZG53wRqgF0XRG3wUK_UQ"
      }
   }
}

Propriedade	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantId`	Identificador da loja no Gateway de Pagamento.	GUID	36	Sim (envio no header)
`MerchantKey`	Chave pública para autenticação dupla no Gateway de Pagamento.	Texto	40	Sim (envio no header)
`RequestId`	Identificador do request, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não (envio no header)
`MerchantOrderId`	Número de identificação do pedido.	Texto	50	Sim
`Customer.Name`	Nome do comprador.	Texto	255	Não
`Customer.Status`	Status de cadastro do comprador na loja ("NEW" / "EXISTING").	Texto	255	Não
`Payment.Type`	Tipo do meio de pagamento.	Texto	100	Sim
`Payment.Amount`	Valor do pedido, em centavos.	Número	15	Sim
`Payment.Provider`	Nome do provedor do meio de pagamento. Obs.: Disponível somente para providers Cielo (Cielo / Cielo30).	Texto	15	Sim
`Payment.Installments`	Número de parcelas.	Número	2	Sim
`Wallet.Type`	Tipo de carteira: "ApplePay" / "SamsungPay" / "GooglePay".	Texto	255	Sim
`Wallet.WalletKey`	Chave criptográfica que representa os dados do cartão. Consultar a tabela WalletKey para mais informações.	Texto	255	Sim

Exemplo de Resposta

{
   "merchantOrderId": "123456789",
  "customer": {
    "name": "Aline de Souza",
    "identity": "58154781050",
    "identityType": "CPF",
    "email": "[email protected]",
    "birthdate": "1990-01-01",
    "ipAddress": "192.168.0.1",
    "address": {
      "street": "Rua das Rosas",
      "number": "123",
      "complement": "apartamento 101",
      "zipCode": "12345987",
      "city": "São Paulo",
      "state": "SP",
      "country": "BR",
      "district": "Jardim das Flores"
    },
    "deliveryAddress": {
      "street": "Rua das Rosas",
      "number": "123",
      "complement": "apartamento 101",
      "zipCode": "12345987",
      "city": "São Paulo",
      "state": "SP",
      "country": "BR",
      "district": "Jardim das Flores"
    },
    "Payment": {
        "ServiceTaxAmount": 0,
        "Installments": 1,
        "Interest": 0,
        "Capture": false,
        "Authenticate": false,
        "Recurrent": false,
        "CreditCard": {
            "CardNumber": "453211******1521",
            "Holder": "BJORN IRONSIDE",
            "ExpirationDate": "08/2035",
            "SaveCard": false,
            "Brand": "Visa"
        },
        "Tid": "0319040817883",
        "ProofOfSale": "817883",
        "AuthorizationCode": "027795",
        "Wallet": {
            "Type": "SamsungPay", "WalletKey":"eyJhbGciOiJSU0ExXzUiLCJraWQiOiIvam1iMU9PL2hHdFRVSWxHNFpxY2VYclVEbmFOUFV1ZUR5M2FWeHBzYXVRPSIsInR5cCI6IkpPU0UiLCJjaGFubmVsU2VjdXJpdHlDb250ZXh0IjoiUlNBX1BLSSIsImVuYyI6IkExMjhHQ00ifQ.cCsGbqgFdzVb1jhXNR--gApzoXH-fdafddfaBo_utsmDN_DuGm69Kk2_nh6txa7ML9PCI59LFfOMniAf7ZwoZUBDCY7Oh8kx3wsZ0kxNBwfyLBCMEYzET0qcIYxePezQpkNcaZ4oogmdNSpYY-KbZGMcWpo1DKhWphDVp0lZcLxA6Q25K78e5AtarR5whN4HUAkurQ.CFjWpHkAVoLCG8q0.NcsTuauebemJXmos_mLMTyLhEHL-p5Wv6J88WkgzyjAt_DW7laiPMYw2sqRXkOiMJLwhifRzbSp8ZgJBM25IX05dKKSS4XfFjJQQjOBHw6PYtEF5pUDMLHML3jcddCrX07abfef_DuP41PqOQYsjwesLZ8XsRjR0TH4diOZ_GQop8_oawjRIo9eJr9Wbtho0h8kAzHYpfuhamOPT718EaGAY6SSrR7t6nBkzGNkrKAmHkC7aRwe.AbZG53wRqgF0XRG3wUK_UQ",
            "Eci": 0
        },
        "SoftDescriptor": "123456789ABCD",
        "Amount": 100,
        "ReceivedDate": "2018-03-19 16:08:16",
        "Status": 1,
        "IsSplitted": false,
        "ReturnMessage": "Operation Successful",
        "ReturnCode": "4",
        "PaymentId": "e57b09eb-475b-44b6-ac71-01b9b82f2491",
        "Type": "CreditCard",
        "Currency": "BRL",
        "Country": "BRA",
        "Links": [
            {
                "Method": "GET",
                "Rel": "self",
                "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/e57b09eb-475b-44b6-ac71-01b9b82f2491"
            },
            {
                "Method": "PUT",
                "Rel": "capture",
                "Href": "https://apisandbox.braspag.com.br/v2/sales/e57b09eb-475b-44b6-ac71-01b9b82f2491/capture"
            },
            {
                "Method": "PUT",
                "Rel": "void",
                "Href": "https://apisandbox.braspag.com.br/v2/sales/e57b09eb-475b-44b6-ac71-01b9b82f2491/void"
            }
        ]
    }
}

--header "Content-Type: application/json"
--header "RequestId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--data-binary
{
  "merchantOrderId": "123456789",
  "customer": {
    "name": "Aline de Souza",
    "identity": "58154781050",
    "identityType": "CPF",
    "email": "[email protected]",
    "birthdate": "1990-01-01",
    "ipAddress": "192.168.0.1",
    "address": {
      "street": "Rua das Rosas",
      "number": "123",
      "complement": "apartamento 101",
      "zipCode": "12345987",
      "city": "São Paulo",
      "state": "SP",
      "country": "BR",
      "district": "Jardim das Flores"
    },
    "deliveryAddress": {
      "street": "Rua das Rosas",
      "number": "123",
      "complement": "apartamento 101",
      "zipCode": "12345987",
      "city": "São Paulo",
      "state": "SP",
      "country": "BR",
      "district": "Jardim das Flores"
    },
    "Payment": {
        "ServiceTaxAmount": 0,
        "Installments": 1,
        "Interest": 0,
        "Capture": false,
        "Authenticate": false,
        "Recurrent": false,
        "CreditCard": {
            "CardNumber": "453211******1521",
            "Holder": "BJORN IRONSIDE",
            "ExpirationDate": "08/2035",
            "SaveCard": false,
            "Brand": "Visa"
        },
        "Tid": "0319040817883",
        "ProofOfSale": "817883",
        "AuthorizationCode": "027795",
        "Wallet": {
            "Type": "SamsungPay",
            "WalletKey": "eyJhbGciOiJSU0ExXzUiLCJraWQiOiIvam1iMU9PL2hHdFRVSWxHNFpxY2VYclVEbmFOUFV1ZUR5M2FWeHBzYXVRPSIsInR5cCI6IkpPU0UiLCJjaGFubmVsU2VjdXJpdHlDb250ZXh0IjoiUlNBX1BLSSIsImVuYyI6IkExMjhHQ00ifQ.cCsGbqgFdzVb1jhXNR--gApzoXH-fdafddfaBo_utsmDN_DuGm69Kk2_nh6txa7ML9PCI59LFfOMniAf7ZwoZUBDCY7Oh8kx3wsZ0kxNBwfyLBCMEYzET0qcIYxePezQpkNcaZ4oogmdNSpYY-KbZGMcWpo1DKhWphDVp0lZcLxA6Q25K78e5AtarR5whN4HUAkurQ.CFjWpHkAVoLCG8q0.NcsTuauebemJXmos_mLMTyLhEHL-p5Wv6J88WkgzyjAt_DW7laiPMYw2sqRXkOiMJLwhifRzbSp8ZgJBM25IX05dKKSS4XfFjJQQjOBHw6PYtEF5pUDMLHML3jcddCrX07abfef_DuP41PqOQYsjwesLZ8XsRjR0TH4diOZ_GQop8_oawjRIo9eJr9Wbtho0h8kAzHYpfuhamOPT718EaGAY6SSrR7t6nBkzGNkrKAmHkC7aRwe.AbZG53wRqgF0XRG3wUK_UQ",
            "Eci": 0
        },
        "SoftDescriptor": "123456789ABCD",
        "Amount": 100,
        "ReceivedDate": "2018-03-19 16:08:16",
        "Status": 1,
        "IsSplitted": false,
        "ReturnMessage": "Operation Successful",
        "ReturnCode": "4",
        "PaymentId": "e57b09eb-475b-44b6-ac71-01b9b82f2491",
        "Type": "CreditCard",
        "Currency": "BRL",
        "Country": "BRA",
        "Links": [
            {
                "Method": "GET",
                "Rel": "self",
                "Href": "https://apiquerysandbox.braspag.com.br/v2/sales/e57b09eb-475b-44b6-ac71-01b9b82f2491"
            },
            {
                "Method": "PUT",
                "Rel": "capture",
                "Href": "https://apisandbox.braspag.com.br/v2/sales/e57b09eb-475b-44b6-ac71-01b9b82f2491/capture"
            },
            {
                "Method": "PUT",
                "Rel": "void",
                "Href": "https://apisandbox.braspag.com.br/v2/sales/e57b09eb-475b-44b6-ac71-01b9b82f2491/void"
            }
        ]
    }
}

Propriedade	Descrição	Tipo	Tamanho	Formato
`ProofOfSale`	Número da autorização, idêntico ao NSU.	Texto	6	Texto alfanumérico
`Tid`	Identificador da transação na adquirente.	Texto	20	Texto alfanumérico
`AuthorizationCode`	Código de autorização.	Texto	6	Texto alfanumérico
`SoftDescriptor`	Texto que será impresso na fatura bancária do portador. Obs.: Não permite caracteres especiais. Disponível apenas para VISA/MASTER.	Texto	13	Texto alfanumérico
`PaymentId`	Campo identificador do pedido.	GUID	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`ECI`	Electronic Commerce Indicator_. Representa o quão segura é uma transação.	Texto	2	Ex.: 7
`Status`	Status da transação.	Byte	2	Ex.: 1
`ReturnCode`	Código de retorno da adquirência.	Texto	32	Texto alfanumérico
`ReturnMessage`	Mensagem de retorno da adquirência.	Texto	512	Texto alfanumérico
`Type`	Tipo de carteira: "ApplePay" / "SamsungPay" / "GooglePay".	Texto	255	Texto alfanumérico
`WalletKey`	Chave criptográfica que representa os dados do cartão. Consultar a tabela Pay, caso para mais informações.	Texto	255	Ver a tabela WalletKey.