Legacy Key Exchange - caddbkeyexchange
Interac (Canadian Domestic Debit) requires a legacy key update once every 200 Interac transactions. This transaction type exists prior to EMV API and has a slightly different response format.
In this section:
Request
ssl_merchant_id 15 | numeric | required | Merchant ID Elavon-assigned Converge account ID. |
ssl_user_id 15 | alphanumeric | required | Converge User ID The user ID with Hosted Payment API User status that can send transaction requests through the terminal. |
ssl_pin 64 | alphanumeric | required | Terminal ID Unique identifier of the terminal that will process the transaction request and submit to the Converge gateway. Important: The ssl_user_id sending the transaction request must be associated with the terminal that will process the request. |
ssl_transaction_type 20 | alphanumeric | required | Transaction Type Value: caddbkeyexchange |
Response
ssl_status | Transaction Result Message A result of SUCCESS indicates that the legacy keys were updated. |
ssl_mac_key | Public Key for MAC Calculation |
ssl_pin_key | PIN Key The public key for processing enciphered PIN ( ssl_pin_block ). |
ssl_reference_number | Transaction Reference Number |
ssl_sys_trace_audit_number | Converge-defined System Trace Audit Number |
[Error] | Returned only if an error occurs. Refer to the Error Codes section for more information. |
errorCode | Error Code Typically, when the transaction failed validation or the request is incorrect. This will prevent the transaction from going to authorization. This is a numeric field. |
errorMessage | Error Message Detailed explanation of the error. This field may be changed based on merchant configuration in the user interface. |
errorName | Error Name Error name or reason for the error. |
Example
<response>
<ssl_sys_trace_audit_number>017944</ssl_sys_trace_audit_number>
<status>SUCCESS</status>
<ssl_mac_key>E859A8F276A5E5C2</ssl_mac_key>
<ssl_pin_key>C5BA9CB7397E2A0A</ssl_pin_key>
<ssl_reference_number>X0000000</ssl_reference_number>
</response>