Definition: POST /v1/payments
In order to initiate a Direct Card payment, you must create a payment object with all the necessary card details.
A token is created and associated with the credit card and the payment.
If you set the GenerateCreditCardToken parameter to true when initiating the payment, a token element is sent in the response, containing the value of the newly created token, that you can use for future payments.
Request:
POST https://securetest.smart2pay.com/v1/payments
Authorization: Basic MTAxMDpnYWJp
{
"Payment": {
"MerchantTransactionID": "s2ptest_h12",
"OriginatorTransactionID": "100_a",
"Amount": 2000,
"Currency": "EUR",
"ReturnURL": "http://demo.smart2pay.com/redirect.php",
"Description": "payment product",
"StatementDescriptor": "bank statement message",
"BillingAddress": {
"City": "Iasi",
"ZipCode": "7000-49",
"State": "Iasi",
"Street": "Sf Lazar",
"StreetNumber": "37",
"HouseNumber": "5A",
"HouseExtension": "-",
"Country": "RO"
},
"ShippingAddress": {
"City": "Iasi",
"ZipCode": "700049",
"State": "Iasi",
"Street": "Sf Lazar",
"StreetNumber": "37",
"HouseNumber": "-",
"HouseExtension": "-",
"Country": "RO"
},
"Customer": {
"MerchantCustomerID": "null",
"Email": "customer@test.com",
"FirstName": "John",
"LastName": "Doe",
"Gender": "1",
"SocialSecurityNumber": "45908-28324",
"Phone": "0744-783322",
"Company": "S2P"
},
"Card": {
"HolderName": "John Doe",
"Number": "4111111111111111",
"ExpirationMonth": "02",
"ExpirationYear": "2018",
"SecurityCode": "312"
},
"Capture": true,
"Retry": true
}
}Response:
HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
{
"Payment": {
"ID": 202242,
"ClientIP": null,
"SkinID": null,
"Created": "20161205093117",
"MerchantTransactionID": "s2ptest_h12",
"OriginatorTransactionID": "100_a",
"Amount": "2000",
"Currency": "EUR",
"CapturedAmount": "2000",
"ReturnURL": "http://demo.smart2pay.com/redirect.php",
"Description": "payment product",
"StatementDescriptor": "bank statement message",
"MethodID": 6,
"MethodOptionID": null,
"SiteID": 1010,
"NotificationDateTime": null,
"Customer": {
"ID": 115,
"MerchantCustomerID": "null",
"Email": "customer@test.com",
"FirstName": "John",
"LastName": "Doe",
"Gender": "1",
"SocialSecurityNumber": "45908-28324",
"Phone": "0744-783322",
"Company": "S2P"
},
"BillingAddress": {
"ID": 253,
"City": "Iasi",
"ZipCode": "7000-49",
"State": "Iasi",
"Street": "Sf Lazar",
"StreetNumber": "37",
"HouseNumber": "5A",
"HouseExtension": "-",
"Country": "RO"
},
"ShippingAddress": {
"ID": 87,
"City": "Iasi",
"ZipCode": "700049",
"State": "Iasi",
"Street": "Sf Lazar",
"StreetNumber": "37",
"HouseNumber": "-",
"HouseExtension": "-",
"Country": "RO"
},
"Articles": null,
"Card": {
"HolderName": "John Doe",
"Number": "VISA-1111",
"ExpirationMonth": "02",
"ExpirationYear": "2018"
},
"CreditCardToken": {
"Value": "6BEBF42B0E43D3BFD360DFB5EFF9D96D"
},
"Status": {
"ID": 11,
"Info": "Captured",
"Reasons": []
},
"MethodTransactionID": null,
"PaymentTokenLifetime": null,
"Capture": true,
"Retry": true,
"RedirectURL": null,
"3DSecure": null
}
}The token element received in the response can be used to initiate future payments, without having to enter all the necesary card details again. Also , the ID’s for the BillingAddress, ShippingAddress, and the Customer received in the initial response can be used to initiate future payments, without having to enter all the details again.
Request:
POST https://securetest.smart2pay.com/v1/payments
Authorization: Basic MTAxMDpnYWJp
{
"Payment": {
"MerchantTransactionID": "s2ptest_h13",
"OriginatorTransactionID": "101_a",
"Amount": 2000,
"Currency": "EUR",
"ReturnURL": "http://demo.smart2pay.com/redirect.php",
"Description": "payment product",
"StatementDescriptor": "bank statement message",
"BillingAddress": {
"ID": 253
},
"ShippingAddress": {
"ID": 87
},
"Customer": {
"ID": 115
},
"CreditCardToken": {
"Value": "6BEBF42B0E43D3BFD360DFB5EFF9D96D",
"SecurityCode": "312"
},
"Capture": true,
"Retry": true
}
}Response:
HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
{
"Payment": {
"ID": 202243,
"ClientIP": null,
"SkinID": null,
"Created": "20161205093245",
"MerchantTransactionID": "s2ptest_h13",
"OriginatorTransactionID": "101_a",
"Amount": "2000",
"Currency": "EUR",
"CapturedAmount": "2000",
"ReturnURL": "http://demo.smart2pay.com/redirect.php",
"Description": "payment product",
"StatementDescriptor": "bank statement message",
"MethodID": 6,
"MethodOptionID": null,
"SiteID": 1010,
"NotificationDateTime": null,
"Customer": {
"ID": 115,
"MerchantCustomerID": "null",
"Email": "customer@test.com",
"FirstName": "John",
"LastName": "Doe",
"Gender": "1",
"SocialSecurityNumber": "45908-28324",
"Phone": "0744-783322",
"Company": "S2P"
},
"BillingAddress": {
"ID": 253,
"City": "Iasi",
"ZipCode": "7000-49",
"State": "Iasi",
"Street": "Sf Lazar",
"StreetNumber": "37",
"HouseNumber": "5A",
"HouseExtension": "-",
"Country": "RO"
},
"ShippingAddress": {
"ID": 87,
"City": "Iasi",
"ZipCode": "700049",
"State": "Iasi",
"Street": "Sf Lazar",
"StreetNumber": "37",
"HouseNumber": "-",
"HouseExtension": "-",
"Country": "RO"
},
"Articles": null,
"Card": {
"HolderName": "John Doe",
"Number": "Ends with 1111",
"ExpirationMonth": "02",
"ExpirationYear": "2018"
},
"CreditCardToken": {
"Value": ""
},
"Status": {
"ID": 11,
"Info": "Captured",
"Reasons": []
},
"MethodTransactionID": null,
"PaymentTokenLifetime": null,
"Capture": true,
"Retry": true,
"RedirectURL": null,
"3DSecure": 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://securetest.smart2pay.com/v1/payments
Authorization: Basic MTAxMDpnYWJp
{
"Payment": {
"MerchantTransactionID": "s2ptest_h14",
"OriginatorTransactionID": "100_a",
"Amount": 2000,
"Currency": "EURO",
"ReturnURL": "http://demo.smart2pay.com/redirect.php",
"Description": "payment product",
"StatementDescriptor": "bank statement message",
"BillingAddress": {
"City": "Iasi",
"ZipCode": "7000-49",
"State": "Iasi",
"Street": "Sf Lazar",
"StreetNumber": "37",
"HouseNumber": "5A",
"HouseExtension": "-",
"Country": "RO"
},
"ShippingAddress": {
"City": "Iasi",
"ZipCode": "700049",
"State": "Iasi",
"Street": "Sf Lazar",
"StreetNumber": "37",
"HouseNumber": "-",
"HouseExtension": "-",
"Country": "RO"
},
"Customer": {
"MerchantCustomerID": "null",
"Email": "customer@test.com",
"FirstName": "John",
"LastName": "Doe",
"Gender": "1",
"SocialSecurityNumber": "45908-28324",
"Phone": "0744-783322",
"Company": "S2P"
},
"Card": {
"HolderName": "John Doe",
"Number": "4111111111111111",
"ExpirationMonth": "02",
"ExpirationYear": "2018",
"SecurityCode": "312"
},
"Capture": true,
"Retry": true
}
}Response:
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
{
"Payment": {
"InvalidRequestID": "i3067",
"ID": null,
"ClientIP": null,
"SkinID": null,
"Created": null,
"MerchantTransactionID": "s2ptest_h14",
"OriginatorTransactionID": "100_a",
"Amount": "2000",
"Currency": null,
"CapturedAmount": "0",
"ReturnURL": "http://demo.smart2pay.com/redirect.php",
"Description": "payment product",
"StatementDescriptor": "bank statement message",
"MethodID": 6,
"MethodOptionID": null,
"SiteID": 1010,
"NotificationDateTime": null,
"Customer": null,
"BillingAddress": null,
"ShippingAddress": null,
"Articles": null,
"Card": null,
"CreditCardToken": null,
"Status": {
"ID": null,
"Info": null,
"Reasons": [
{
"Code": "1002",
"Info": "Payment.Currency is invalid"
}
]
},
"MethodTransactionID": null,
"PaymentTokenLifetime": null,
"Capture": null,
"Retry": true,
"RedirectURL": null,
"3DSecure": null
}
}