v1

latestOpenAPI 3.1.02026-08-0425501.2 MB

Encryption Fetch API

To fetch the details, pass either Transaction ID alone or Vault ID along with Payment ID to retrieve the Encrypted PAN, Encrypted Session Key, and Key Label.

post/?vault-fetch

Request body

appidstring required

Merchant APP ID (Alphanumeric - Length of 32 chars and special chars $@%#)

appkeystring required

Merchant APP KEY (Alphanumeric - Length of 32 chars and special chars $@%#)

epistring required

EPI is an end point identifier, Identify the device on valor infrastructure, it's a 10 digit number starts with 2

txn_typestring required

Transaction type should be set as 'fetchEncryptedInfo'

txn_idstring

A unique response transaction ID from the response of a sale transaction (Numeric - Length of 20 chars)

CustomerProfileIDstring

Vault customer profile ID

PaymentProfileIDstring

Vault customer payment profile ID

Response

200

error_nostring

error_codestring

Example response

{
  "error_no": "S00",
  "error_code": "00",
  "data": {
    "masked_pan": "XXXX2333",
    "token": "C8520141793100B8617EE7BA84B9FEFA1093B7F7",
    "card_type": "D",
    "card_brand": "Visa",
    "spx_encrypted_pan": "C8A7CA00566EA1772BC5F77B8D25F8E1908A749C4B5DDE9ACD841AE2DD97065D58432C1649BFC86360F1ABE19134395522",
    "spx_iso_key_label": "Test",
    "spx_iso_session_key": "UOJGpbCrmTPz6AS5ti0s8lwOotRQ/bsWUlqlZ7gb3Y9EozP8OQLe0Vqr1HnawvQZUg/1A3FjcpjBHNWujByqoqEAEiYarwWw5YtuVMAoeVhqCL23CD73qr3EukfgKsvpYt2q9GYi97XJg+r4+Kxg0q3JQP7+oYuY3py55VnF/Ve2JUEX0VjNlmhmf1gbB+LEYxXjgnzSEAWzwuDGB5XFxvoMjF9ZX2Y5UPgA8aZEWMAnKEA8pJiml6dru9DUcMtsYzCov04LH4IR8WqXKI8WpXNjGt+zLeNGtxpsqLLRy3Mb0i8grqzsWrPHE2h7dLsoxVP6jPR3tINrSKoW2tJq2Q==",
    "customer_name": "WM32"
  }
}