Customer Creation
Creating a customer in the Ezypay system gets them ready for billing. Ezypay allows each customer to have multiple payment method tokens - with the first token linked - treated as the primary one.
https://developer.ezypay.com/docs/creating-customers
Important Items
Customer Validation and Consent
The partner platform is required to implement robust validation processes when onboarding new customers. This can be achieved through the verification of email addresses or mobile numbers, which serves as a reliable method for confirming the authenticity of the customer. Such measures are crucial in preventing fraudulent activities.
Besides that, Ezypay’s terms and conditions must be displayed and agreed to by the customer. Customer consent on using Ezypay service is mandatory before billing can occur. The terms and conditions are included in the Ezypay-hosted payment page. Alternatively, please display the T&Cs from Ezypay Terms & Conditions.
Display Customer Paid Fees
Ezypay provides flexible configuration options allowing merchants to either cover fees (merchant paid) or have the customer pay them (customer paid). It is crucial to inform customers about any additional fees they will be charged to avoid confusion or disputes. Please refer to the Ezypay Fees section for details on how fees are applied.
Key Customer Information to be collected
Parameters | Description | Why its required? |
---|---|---|
firstName | Billing customer first name | Information recorded into Ezypay to identify who this customer is by the first name. |
lastName | Billing customer last name | Information recorded into Ezypay to identify who this customer is by their last name |
email | Billing customer Email address | Required information to allow Ezypay to send notification to the correct email address. |
mobilePhone | Billing customer mobile number | Required information to allow Ezypay to contact the customer via SMS if a payment failed |
referenceCode | Customer number in the partner's platform | Important for reconciling process and mapping of customer in both Ezypay and partner's system. |
Supporting All Regional Payment Methods
Ezypay supports multiple types of payment methods based on different regions. Partners' platforms must accept all payment methods for their respective regions to ensure seamless integration. For more details, refer to the Ezypay Supported Payment Methods.
Payment Methods Collection
Ezypay offers a PCI-compliant hosted payment page (HPP) for collecting payment methods This page can be embedded in your application, providing a single integration point to collect all types of payment methods. Information captured by the HPP flows securely to Ezypay without passing through your backend server, removing the need for PCI compliance to transact with cards. Note that Ezypay does not request CVV for cards.
For integration details, refer to the Ezypay HPP Integration Guide.
Important Items for Partners
- You must store the primary payment method token in your platform’s database.
- You must record the last 4 digits of the card, payment method validity, card/bank type, card expiry date, and payment method token.
- You must ensure each customer has at least one valid payment method stored; otherwise, billing will not be possible.
- You must ensure each customer is attached to a valid payment method token.
Showing card information helps customers identify which payment method they are currently using and allows them the time to check if the payment method is still valid.
Showing card information helps customers identify which payment method they are currently using and allows them the time to check if the payment method is still valid.
Multiple Payment Methods
Ezypay allows multiple payment methods per customer. Customers can choose different payment methods for different transactions without re-entering information. Use the embedded Ezypay HPP in the customer portal to collect additional payment methods.
Checkout page
Ezypay offers a PCI-compliant checkout page for immediate customer-initiated payment collections using a valid Credit Card. This page, hosted by Ezypay, allows customers to:
a. Enter personal information and register with Ezypay if not already registered.
b. Review and agree to Ezypay terms and conditions.
c. Enter their payment method.
d. Confirm the amount to be paid.
e. Receive immediate transaction status of the payment
A payload with the Customer ID and payment method token is returned to the partner's preferred URL upon completion. Note that only cards are accepted on the checkout page due to the nature of instant response required. For implementation details, refer to the Ezypay Checkout Page Guide.
Updated 5 days ago