Definition: POST /v1/preapprovals
To initiate a preapproval, you must create a preapproval object. The parameters of the preapproval are sent in the message body as a JSON object. See below an example of a preapproval request for AlipayHK (1143).
Request:
POST https://paytest.smart2pay.com/v1/preapprovals
Authorization: Basic MzAyMDE6KzlLZUd6S0Y3VzhTLzc5YTVSMzNZSlVnN0U3V0ZOY1piakdmekxWM2JYU25GQ095RnQ=
{
"Preapproval": {
"MerchantPreapprovalID": "s2ptest_alipayhk1",
"Currency": "HKD",
"Description": "1 year subscription",
"ReturnURL": "http://demo.smart2pay.com/redirect.php",
"MethodID": 1145,
"Customer": {
"FirstName": "John",
"LastName": "Doe",
"Email": "jdoe@gmail.com"
},
"BillingAddress": {
"Country": "HK"
}
}
}Response:
HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
{
"Preapproval": {
"ID": 28082,
"Created": "20210202165209",
"MethodID": 1145,
"SiteID": 30201,
"MerchantPreapprovalID": "s2ptest_alipayhk1",
"RecurringPeriod": 0,
"PreapprovedMaximumAmount": null,
"Currency": "HKD",
"ReturnURL": "http://demo.smart2pay.com/redirect.php",
"Description": "1 year subscription",
"Customer": {
"ID": 2625948,
"MerchantCustomerID": null,
"Email": "jdoe@gmail.com",
"FirstName": "John",
"LastName": "Doe",
"Gender": null,
"SocialSecurityNumber": null,
"Phone": null,
"Company": null,
"DateOfBirth": null
},
"BillingAddress": {
"ID": 986,
"City": null,
"ZipCode": null,
"State": null,
"Street": null,
"StreetNumber": null,
"HouseNumber": null,
"HouseExtension": null,
"Country": "HK"
},
"Status": {
"ID": 1,
"Info": "Pending",
"Reasons": null
},
"RedirectURL": "https://europaytest.smart2pay.com/AlipayOSP/Preapproval/PreapprovalLanding.aspx?ID=23265&Hash=030CBF27F3759B369266CCBC5D84C98A",
"MethodOptionID": 0,
"PreapprovedFrequency": null,
"MandateReference": null,
"Details": null
}
}AlipayHK Preapproval Flow
| AlipayHK Test Data | ||
|---|---|---|
| Data | Value | |
| Phone Number: | Enter any 10 digit number. Example: 1234567812 | |
| Verification code: | Enter any 6 digit number. Example: 123456 | |
| Payment password: | Enter any 6 digit number. Example: 123456 | |
- The customer is redirected to AlipayHK page. The customer needs to add their phone number attached to the AlipayHK wallet.
- The customer enters the SMS verification code received via mobile phone.
- The customer sees the preapproval details, agrees with the AlipayHK Terms and Conditions and confirms the auto-debit user agreement.
- The customer enters the payment password. For testing purposes, enter any 6 digit number eg. 123456.
- The customer is redirected to the AlipayHK confirmation page.
- Upon completion of the payment flow, the customer is redirected to your ReturnUrl.
