Definition: POST https://paytest.smart2pay.com/v1/payments
Below you will find a full example of a payment request for Alipay method (with Success and Bad response). The parameters of the payment are sent in the message body as a JSON object.
For Alipay payments only the following Articles parameters are mandatory to be sent in the request, the rest of them are optional:
- Name – Article’s name;
- Quantity – The number of products.
A 201 HTTP response (Created) is returned if the payment was correctly initialized.
For more information about status codes, please go to Basic HTTP Status Codes.
Request:
POST https://paytest.smart2pay.com/v1/payments
Authorization: Basic MzAyMDE6aEo1Um9iWXg5cjdGZk53Q3ZIWTlMWEhxcXIrRkV6cmM3YUp2UVFrNEdhejFtZzdSeXk=
{
"Payment": {
"MerchantTransactionID": "s2ptest_h31",
"Amount": "100",
"Currency": "CNY",
"MethodID": 24,
"ReturnURL": "http://demo.smart2pay.com/redirect.php",
"TokenLifetime": 10,
"BillingAddress": {
"Country": "CN"
},
"Articles": [
{
"Name": "TEST",
"Quantity": 1
}
]
}
}Response:
HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
{
"Payment": {
"ID": 4201852,
"SkinID": null,
"ClientIP": null,
"Created": "20181120122556",
"MerchantTransactionID": "s2ptest_h31",
"OriginatorTransactionID": null,
"Amount": "100",
"Currency": "CNY",
"CapturedAmount": null,
"ReturnURL": "http://demo.smart2pay.com/redirect.php",
"Description": null,
"MethodID": 24,
"MethodOptionID": null,
"IncludeMethodIDs": null,
"ExcludeMethodIDs": null,
"PrioritizeMethodIDs": null,
"SiteID": 30201,
"NotificationDateTime": "20181120122556",
"Customer": null,
"BillingAddress": null,
"ShippingAddress": null,
"Articles": [
{
"MerchantArticleID": null,
"Name": "TEST",
"Quantity": 1,
"Price": null,
"VAT": null,
"Discount": null,
"Type": null,
"TaxType": null,
"DiscountValue": null
}
],
"Details": null,
"ReferenceDetails": null,
"CustomParameters": null,
"PreapprovalID": null,
"Status": {
"ID": 1,
"Info": "Open",
"Reasons": null
},
"MethodTransactionID": null,
"TokenLifetime": null,
"Capture": null,
"PreapprovalDetails": null,
"RedirectURL": null
}
}In case of an API error, an HTTP 4xx (you did something wrong) or HTTP 5xx (we did something wrong) response is returned.
For more information about the reasons of a wrong request response see our section GlobalPay Return Codes.
Request:
POST https://paytest.smart2pay.com/v1/payments
Authorization: Basic MzAyMDE6aEo1Um9iWXg5cjdGZk53Q3ZIWTlMWEhxcXIrRkV6cmM3YUp2UVFrNEdhejFtZzdSeXk=
{
"Payment": {
"MerchantTransactionID": "s2ptest_h32",
"Amount": "100",
"Currency": "CN",
"MethodID": 24,
"ReturnURL": "http://demo.smart2pay.com/redirect.php",
"TokenLifetime": 10,
"BillingAddress": {
"Country": "CN"
},
"Articles": [
{
"Name": "TEST",
"Quantity": 1
}
]
}
}
Response:
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
{
"Payment": {
"ID": null,
"SkinID": null,
"ClientIP": null,
"Created": null,
"MerchantTransactionID": "s2ptest_h32",
"OriginatorTransactionID": null,
"Amount": "100",
"Currency": "CN",
"CapturedAmount": null,
"ReturnURL": "http://demo.smart2pay.com/redirect.php",
"Description": null,
"MethodID": 24,
"MethodOptionID": null,
"IncludeMethodIDs": null,
"ExcludeMethodIDs": null,
"PrioritizeMethodIDs": null,
"SiteID": null,
"NotificationDateTime": null,
"Customer": null,
"BillingAddress": null,
"ShippingAddress": null,
"Articles": null,
"Details": null,
"ReferenceDetails": null,
"CustomParameters": null,
"PreapprovalID": null,
"Status": {
"ID": null,
"Info": null,
"Reasons": [
{
"Code": "2",
"Info": "Validation failed - Currency (RegEx: ^[A-Z]{3}$)"
}
]
},
"MethodTransactionID": null,
"TokenLifetime": null,
"Capture": null,
"PreapprovalDetails": null,
"RedirectURL": null
}
}
