EdgePay Pivot is a JavaScript Library and Function that you can add to your Payment page and bypass sending sensitive card data to your server, thus eliminating the risks associated with storing, processing, or transmitting credit card data and allows you to operate in a PCI Compliance way.
You would use this Library and Function if do not want to store, process, or transmit card data on your system. If your design already includes server-side card processing, this library and function may not be for you.
Dealing with Pivot Key Responses
Here is a table of all responses and appropriate action to take:
| RESULT | RESPONSE CODE | RESPONSE MESSAGE | RECOMMENDED NEXT ACTION |
|---|---|---|---|
| A | EP0020 | Pivot Key Generation Successful | Use the Pivot Key to generate Payment Page |
| C | EP0900 | Message format not supported | Call GET for support |
| C | EP0102 | The value 'xxx' of element 'merchantID' is not valid | The Merchant ID in the request packet is not valid. Verify your input |
| C | EP0102 | The value 'xxx' of element 'terminalID' is not valid | The Terminal ID in the request packect is not valid. Verify your input |
| C | EP0012 | Authentication failed, please use valid credentials | The Merchant Key is not valid. Update Merchant key. |
| D | EP0101 | The value of element 'externalReferenceID' is missing | The externalReferenceID must be included with every request, and be unique |
| D | EP0101 | The value of element 'merchantID' is missing | The merchantID must be included with every request, and be unique |
| D | EP0101 | The value of element 'terminalID' is missing | The terminalID must be included with every request, and be unique |
| R | EP0999 | System Error | Internal Server error, please retry request |
Full Response Format
Here are the details of the Pivot Key response message:
| FIELD | ATTRIBUTE | DESCRIPTION |
|---|---|---|
| result | A/1 | A = Approved D = Decline R = Retry C = Call for Help |
| responseCode | AN/6 | The 6-digit code and the table below may be used for determining next step in your code |
| result | A/1 | A = Approved D = Decline R = Retry C = Call for Help |
| responseMessage | AN String | Text describing the condition |
| timestamp | N/Calendar | YYYY-MM-DD-hh-mm-ss |
| pivotAuthKey | 256 bits | JSON Web Key |