X-Payments:Managing PIN codes (X-Payments versions 2.2 and earlier)

X-Payments user manual

1. X-Payments:General information
   • How It Works
   • Key features
2. What's New
   • What's New in X-Payments 3.1
   • What's New in X-Payments 3.0
3. System requirements
   • System requirements for X-Payments 3
   • System requirements for X-Payments 2.2
4. Installation
   • Installing X-Payments
   • Setting up file permissions for X-Payments
   • Getting started with X-Payments
5. Two-factor user authentication
   • Two-factor authentication (X-Payments 3)
   • Managing PIN codes (X-Payments 2.2 and earlier)
6. Configuring X-Payments
   • General settings
   • Online stores
   • Payment configurations
   • Encryption keys
   • 3D-Secure settings
   • KOUNT Antifraud screening
   • NoFraud fraud prevention
   • Signifyd fraud protection and chargeback prevention
7. Managing users
8. Customizing the interface
   • Customizing the interface (X-Payments 3)
   • Customizing the interface (X-Payments 2.2 and earlier)
9. Managing payments
10. Unistalling X-Payments
11. Upgrading
12. Moving X-Payments from one host to another
13. Viewing X-Payments logs
14. FAQ
15. Troubleshooting
16. Glossary
17. Supported payment gateways
    • Payment gateways supported by X-Payments 3.1
    • Payment gateways supported by X-Payments 3.0
    • Payment gateways supported by X-Payments 2.2
18. Popular Payment Methods Configuration Instructions
    • PayPal Payments Pro (PayPal API), PayPal Payments Pro (Payflow API), Payflow Pro
    • PayPal REST API
    • First Data Payeezy Gateway (ex- Global Gateway e4)
    • CyberSource - SOAP toolkit API

X-Payments provides a reliable level of user authentication: to be able to log in to the X-Payments back end, a user needs not just a login and password, but also an additional value - a PIN code.

A set of PIN codes is generated for each X-Payments user account at the time of account creation. After installing X-Payments, the administrator receives an email message that includes five PIN codes. These can be used to log in to the X-Payments back end for the first few times. When the administrator feels they are about to run out of available PIN codes, he or she can log in to the X-Payments back end and order a new PIN codes set to be generated (See the instructions below). Other X-Payments users receive their PIN codes in a similar way: when a new user account is created, the PIN codes list is mailed to the email address associated with that account. When the user needs more PIN codes, they can log in to X-Payments and generate more.

A standard X-Payments PIN codes set includes 100 codes, each of which can be used only once. PIN codes must be used in the specified order, according to their numbers. If you enter an incorrect PIN code on login, you will be offered to try again, and X-Payments will request the same PIN code number until you enter it correctly.

When you have used all but five last PIN codes from your PIN codes table, a reminder for you to generate new PIN codes will be displayed on the Dashboard in X-Payments while you are logged in:

Generating PIN codes using the X-Payments interface

When you are about to run out of PIN codes for logging in to the X-Payments back end, log in to X-Payments using one of the PIN codes you still have and generate a new PIN codes table.

To generate a new PIN codes list, do the following:

1. In the X-Payments back end, go to your 'Account details' page.
2. Click the Generate PIN codes button.
   
   A new set of PIN codes for your account will be generated (You will see a success message at the top of the page).
3. Click the View PIN codes link. A table with your PIN codes list will be displayed.
4. Choose how you would like to save your PIN codes by clicking the respective button below the table:
   • Print
   • Save as picture...
   • Save as text...
5. Follow the instructions on the screen to save the PIN codes.

Generating PIN codes using the script pin.php

It is impossible to generate PIN codes for another user using the X-Payments interface, but you can do so by running a special script. You will need to specify the email address of the X-Payments user for whom the PIN codes will be generated.

Note: This method can be used by the X-Payments admin to generate five PIN codes for himself as well.

To generate PIN codes using this method, open the console and enter:

<path to PHP interpreter> php pin.php user@example.com

(Be sure to enter the actual path to PHP interpreter and replace user@example.com with the email address of the user who needs PIN codes).

After the script completes, five PIN codes will be sent to the specified email. After logging in to X-Payments, the user will be able to generate a complete PIN code table.

This article can be downloaded as a PDF file