Setup and Integration
Enhancement of Recurring Features
This feature is only applicable for merchants who owns a website only
Introduced new features that enhance the functionality and convenience for merchants. These features specifically focus on managing recurring payments and offer more flexibility to the merchant.
By enabling this functionality, merchant will receive timely responses for their three types of actions as in (A), (B) and (C) below. Merchant need to setup the recurring callback URL to receive the responses.
Additionally, if a buyer making action as in (C), merchant will also receive the response.
How to enable the features ?
1. Go to Settings > Profile
2. Merchant has to set recurring callback URL
3. Fill the callback URL ,
A. Enable new payment schedule (installment)
Add new payment schedules through the senangPay dashboard. This feature allows to set up recurring payments for your customers at specific intervals, such as daily, weekly, monthly, or annually. The payment schedule can be customized based on the merchant’s requirements.
1. Go to Recurring > Recurring Instalment List
2. Click on your chosen customer’s name
3. Click on Edit Detail button.
4. Scroll to bottom and click on Add Schedule.
Response parameters
| Parameter | Value | Details |
|---|---|---|
| action | ‘new_schedule’ | action performed |
| new_payment_timestamp | 1688657245 | timestamp value |
| recurring_id | 1554006332 | id of recurring |
| type | ‘installment’ | |
| customer_email | [email protected] | customer’s email |
| hash | hash value⇒ hash sha256 of the following string: {secretkey}{recurring_id}{type}{customer_email} | hash value |
B. How to remove payment schedule (installment)
Remove specific recurring payment schedules from the system. Whether it’s due to customer requests or any other reason, merchant can quickly and conveniently terminate a recurring payment schedule, preventing any further transactions from taking place.
1. Repeat steps 1,2 and 3 as shown in (A).
2. Scroll to bottom and click on Cancel Installment.
Response parameters
| Parameter | Value | Details |
|---|---|---|
| action | ‘remove_schedule’ | action performed |
| new_payment_timestamp | 1688657245 | timestamp value |
| recurring_id | 1554006332 | id of recurring |
| type | ‘installment’ | |
| customer_email | [email protected] | customer’s email |
| hash | hash value⇒ hash sha256 of the following string: {secretkey}{recurring_id}{type}{customer_email} | hash value |
C. How to terminate recurring
Allows merchants to completely stop any future transactions associated with a particular recurring payment schedule. It can be useful in cases where the merchant wants to discontinue a specific service or if the customer decides to cancel the recurring payment arrangement.
1. Repeat steps 1,2 and 3 as shown in (A).
2. Scroll to bottom and click on Stop Recurring.
Buyer action for termination
Merchants also can allow buyer to stop future transaction.
1. Go to Product > List and select your chosen product
2. Merchant also has to allow cancel when create/edit product form .
3. Send this link : https://billing.senangpay.my/ and guide your buyer to login. Go to Subscription List/Installment List . Click active product > terminate.
Response parameters
| Parameter | Value | Details |
|---|---|---|
| action | ‘terminate’ | action performed |
| new_payment_timestamp | 1688657245 | timestamp value |
| recurring_id | 1554006332 | id of recurring |
| type | ‘installment’ or ‘subscription | |
| customer_email | [email protected] | customer’s email |
| hash | hash value⇒ hash sha256 of the following string: {secretkey}{recurring_id}{type}{customer_email} | hash value |