FAQ

Answers to frequently asked questions

Integration Options

What are the options available for integrating Number with Verifone card readers?

Number offers four options: Desktop application, Number Verifone SDK, Browser-based installation, and Virtual Terminal support.

How do I implement the Number Verifone SDK in my application?

To implement the Number Verifone SDK, download the DLL, include it in your project, and follow the integration guidelines provided in the Verifone integration guide to set up payment processing.

Can I use Number and Verifone with a web application?

Yes, Number provides a browser-based interface that allows integration with web applications using Cross-Origin Resource Sharing (CORS) to communicate with Verifone devices.

You can find the full implementation details in the Verifone integration guide.

Security and Compliance

How does Number ensure the security of cardholder data?

Number utilizes end-to-end encryption (P2PE) to secure cardholder data, ensuring it remains encrypted during transmission to the PCI Level One compliant processing platform.

What is HMAC, and why is it important in the Number API?

HMAC (Hash-based Message Authentication Code) is used to create a hash that verifies the authenticity of requests when passing cardholder data through the Number API.

What are the requirements for passing cardholder data through the Number API?

To pass cardholder data through the Number API, you need a session key, HMAC secret, and RSA Certificate to encrypt the credit card number before transmission.

You can read more in HMAC and RSA section of our Authentication guide.

How can I manage token renewal for Number?

You can manage token renewal through the Number Client Admin Portal, where you can create new tokens and view existing ones. Tokens expire every six months.

You can read more about token renewal in our Client Admin Portal guide.

Session Management

How do I manage session keys when using the Number API?

Call the authenticate method to obtain a session key using your account code and token. The session will be valid for 25 hours or until you change your IP. If you receive error codes 5030 or 5050, re-authenticate to obtain a new session key.

Read more in our Authentication guide.

What should I do if my session key expires?

If your session key expires, you will need to authenticate again to obtain a new session key. Monitor for expiration codes to ensure continuous access.

Read more in our Authentication guide.

What happens if I exceed the number of unsuccessful authentication attempts?

If you exceed six unsuccessful authentication attempts, your IP address will be locked out, requiring manual intervention from Number support to unlock it.

Read more in the Lockouts section of our Authentication guide.

How can I check if my authentication was successful?

After authentication, check the FunctionOK and AuthSuccess flags. If both are true, you will receive a session key; otherwise, read the error messages and abort the process.

Payment Processing

What types of transactions can I process using Number?

Number allows you to process various types of transactions, including authorizations, credits, voids, settlements, and recurring payments through card-on-file plans

How do I handle refunds using the Number system?

To process refunds, you can use the Number API to initiate a credit transaction against the original payment. Ensure you have the original transaction ID to reference during the refund process.

What is the process for creating card-on-file payment plans using Number?

You can create card-on-file payment plans using a variety of channels such as the Virtual Terminal, our APIs, PayForm, widgets, and the Win service for Verifone. All of those options allow you to manage recurring payments and consent agreements.

To find out more, we recommend reading the Card Sales and Consent quickstart guide.

How can I ensure that my transactions are secure?

Number employs end-to-end encryption (P2PE) for all transactions, ensuring that cardholder data is encrypted during transmission between the Verifone device and the Number cloud servers.

Reconciliation

How can I ensure that my database contains accurate transaction data?

We recomend that your system periodically query our database to ensure you have accurate data. Webhooks are provided for real-time notifications, but you can augment this with transaction queries.

Read more about reconciliation in Reconciliation section of the Querying reference.