REST API

Generating a Hash of the Token Header

Generate a Base64-encoded SHA-256 hash of these header fields:
x5c
The X.509 certificate's private key used to digitally sign the token.
alg
Algorithm used to sign the token header.
v-c-merchant-id
Merchant ID used in the request transaction.
Follow these steps to generate the hash:
  1. Generate the SHA-256 hash of the fields in JSON format.
  2. Encode the hashed string to Base64.

Example: Token Header Hash

NTc3N2RlOTAyZWEwNWU0NWM2YTBkNTI4Mjg0YTJmOTVlZGYxYWJlMzBjNzk5OTg1YzEzMjNiMDkzMzc0MWEwNA==

Code Example: Creating a Message Hash Using Command Line Tools

Generate the SHA-256 hash using the
shasum
tool.
echo -n "{"x5c":"MIIEvwIBADANBgkqhkiG9w0BAQEFAASCBKkwggSlAgEAAoIBAQCnpt EmZf+Oh7Szp6UFM8TB0Z/gxvo0x1AHCYT1GNHL3cn1TzZ9ZytG8kinmKsH9Prtp bEvTC1Ifrt3ajLG/YogByVJeCG6je07kGJ2raemmVWHXUxIKkWqoxvad9/82L+y AI/4vKVwXJkgN8kFS96kdUWF1EHw8eIn/+PQnL+EB4I1tgedSHgwJLUxWbE6peJ +YThSAAqH7+6CupWEXToVSJSuefo7OQulCN+xqrbJUPkwzIRe3W57MBR35+J0LJ m7K1M8dofzYHAAXBsSWCC2u6my0TVidYiymt5VhRT50yISNjXX1bub/c21Y6v3w XFeH9DsdSMrWEhj4G5H5huRAgMBAAECggEAWgM72kT7UBhWkfrZpBBmfLXDBFlw 7zNwKUcYJsw7oBylmVr9Y5kn6ECfd7SFZ5FFxKCooD9jNMAugO/48VQhfA66G1c vrM0U6V0dMKEOGWnMPRB/q2Ne4j4O715bWZM6YSTiJ+eJX+mnoV+yQ3C3yk7YlA Ehom8MQPOn6lKulQDdndK05DIwxnQFlHnK2VEbiBkFPcSritS27TyQ7KBViveqc thRO2RbzVL4lgWIjTJKVLy9zdJcdc8l0h9ZXDfzKqO5+AXTC9jwh0RjrhZ560k+ J2rVsk/3nEXKkrCyH1a0ZsAr7ygZEXGbnTaWg0ma0TUbbL39uLTFXrpkVW9bUQK BgQDz7GC/L0cUQwJa9hY4YRzb/UuM6eOKbJIv0GPuO/PpgW9RaKBn/Relka3O2/ 2z1RhAi4rv8eh/Hkd6AFNT44B3az3Tfb8BmlnPXAU0zNky1LvAHbX3ki4dk5hf2 hiyqE0FXTfY/btj5xeMc6ev2W38uI7UbYLCeJL1Dlcj0GkefQKBgQCv87pvYgtH ICLl242C+BPoKg1YEX+H9fCJEeXAnUyNxrAQ/R6Iy0bHRSo0aVgS/bAi1lfF7GY lS1k+eYz6zB4X47ilXjPnn1fGVZkmWY9uCJ+nztKF2ootnsyqFmNDFbiibt52WZ NARp795vySGEHoFkyohi7L8olGEUIddHxZpQKBgQCK/cajKm12Pji5XECNH8kyE cNbKGtgFT23wScwOTljdT3ZRaUhnDY9QiWoGfMW5fZL0Tf6Qf4ZcUeJXWYeByTM 527zdFPCthE291iAHbomHNJfRo7J46IjeFb7R2uLYhuBUvzfyLVe1++zOLP0oBD sUL4SjdRUvCABQ4qj/b3ogQKBgQCoDE92zBxbXR0Xjf71JHzW0zsVbvjv4PxP3d Eiitmv2yETyLzeB8/cyHlLv4VH9hXA4BjKx0KzwehFnBADBOqFBJC5GGTYhr5th hmUoBs2C3R48Dbvcs9gTPfKR0Gcs+U49kzwmhLiY9C8TV3TJunjgVDL8ARH86ga TKdpvHR7pQKBgQDIznnx2uqiO87W5B7CnN1T0lE3CEm+n9IPRNsFMTgmmd+BwUd 2xalV3OJmWvmz4plxN+JMjPRCC0cq6Fnn+esq8AK35Bqj7l82ydF0DlKeCh2PmK Jr4ON6Y7Pmn0St65MOaKsf+wRrAdvl242UxbW+rXVFOw2lLN8/g0E7EEh4Gg==" ,"alg":"RS256","v-c-merchant-id":"merchant_id"}" | shasum -a 256
Base64-encode the hash value using the
base64
tool.
echo -n "5777de902ea05e45c6a0d528284a2f95edf1abe30c799985c1323b0933741a04" | base64