Skip to content

Samsung Pay payments with decrypted 3DS.data (payload)

The bePaid system can process payment, authorization and charge requests with the decrypted 3DS.data (payload) provided by Samsung.

Info

You must be Payment Card Industry Data Security Standard (PCI DSS) compliant to decrypt and store the payment tokens from Samsung Pay.

Request

To initiate a payment with the decrypted Samsung Pay data, send the payment, authorization or charge request, where you should submit the decrypted Samsung Pay token as the value of request.credit_card.token in the format described below.

The required format of the decrypted Samsung Pay token sent as the card token

Submit the decrypted Samsung Pay token in requests as the card token in the $begateway_samsung_pay_decrypted_1_0_0$<base64-decoded_payload_here> format, where:

  • $begateway_samsung_pay_decrypted_1_0_0$ is the required prefix for the decrypted Samsung Pay token;
  • <base64-decoded_payload_here> is the decrypted 3DS.data (payload) property of the paymentCredentials serialized into JSON and then converted to the Base64-strict format.

For recurring payments and payments with the saved card data, get the bePaid payment token by sending the request.additional_data.contract parameter in the payment, authorization or charge requests.

The required format of the JSON-serialized decrypted 3DS.data property

{
  "amount": "5000",
  "currency_code": "USD",
  "utc": "1614158346494",
  "eci_indicator": "5",
  "tokenPAN": "4200000000000000",
  "tokenPanExpiration": "0124",
  "cryptogram": "AAkHJQYMK0P6ADfrsRHVAoACFA=="
}
Example of the of the payment request with the decrypted Samsung Pay token 
{
  "request":{
    "amount":5000,
    "currency":"USD",
    "description":"Samsung Pay transaction",
    "tracking_id":"your_uniq_number",
    "credit_card":{
      "token":"$begateway_samsung_pay_decrypted_1_0_0$eyJhbW91bnQiOiI1MDAwIiwiY3VycmVuY3lfY29kZSI6IlVTRCIsInV0YyI6IjE2MTQxNTgzNDY0OTQiLCJlY2lfaW5kaWNhdG9yIjoiNSIsInRva2VuUEFOIjoiNDIwMDfWMDAwMDAwMDAwMCIsInRva2VuUGFuRXahwXJhdGlvbiI6IjAxMjQiLCJjcnlwdG9ncmFtIjoiQUFrSEpRWU1LMFA2QURyZnNSSFZBb0FDRkE9PSJ9"
    }
  }
}
Response

The response to the payment request with the decrypted 3DS.data (payload) is returned with the final transaction processing status. It fully matches the response to payment or authorization requests.