Payment
Payment transaction is a combination of authorization and capture processed at a time. This transaction type is generally used when the goods or services can be immediately provided to the customer.
Info
It is required to be PCI DSS validated to use this transaction and send plain unencrypted card data.
Request
To initiate a payment transaction, send a POST
request to https://gateway.pay-cross.com/transactions/payments
with the following parameters:
Note
The request body must be wrapped in a top-level request{} object.
|
Example of the request
{
"request":{
"amount":100,
"currency":"USD",
"description":"Test transaction",
"tracking_id":"your_uniq_number",
"language":"en",
"test":true,
"billing_address":{
"first_name":"John",
"last_name":"Doe",
"country":"US",
"city":"Denver",
"state":"CO",
"zip":"96002",
"address":"1st Street"
},
"credit_card":{
"number":"4200000000000000",
"verification_value":"123",
"holder":"John Doe",
"exp_month":"05",
"exp_year":"2027"
},
"customer":{
"ip":"127.0.0.1",
"email":"[email protected]"
}
}
}
Example of the request with card token
{
"request":{
"amount":100,
"currency":"USD",
"description":"Test transaction",
"tracking_id":"your_uniq_number",
"test":true,
"billing_address":{
"first_name":"John",
"last_name":"Doe",
"country":"US",
"city":"Denver",
"state":"CO",
"zip":"96002",
"address":"1st Street"
},
"credit_card":{
"token":"40bd001563085fc35165329ea1ff5c5ecbdbbeef40bd001563085fc35165329e"
},
"customer":{
"ip":"127.0.0.1",
"email":"[email protected]"
}
}
}
Example of the request with additional receipt text
{
"request":{
"amount":100,
"currency":"USD",
"description":"Test transaction",
"tracking_id":"your_uniq_number",
"language":"en",
"test":true,
"billing_address":{
"first_name":"John",
"last_name":"Doe",
"country":"US",
"city":"Denver",
"state":"CO",
"zip":"96002",
"address":"1st Street"
},
"credit_card":{
"number":"4200000000000000",
"verification_value":"123",
"holder":"John Doe",
"exp_month":"05",
"exp_year":"2027"
},
"additional_data":{
"receipt_text": ["First line", "Second Line"]
},
"customer":{
"ip":"127.0.0.1",
"email":"[email protected]"
}
}
}
Example of the request for MCC 4829 money transfers
{
"request": {
"amount": 100,
"currency": "USD",
"description": "Test transaction",
"tracking_id": "your_uniq_number",
"language": "en",
"test": true,
"credit_card": {
"number": "4200000000000000",
"verification_value": "123",
"holder": "John Doe",
"exp_month": "05",
"exp_year": "2027"
},
"additional_data": {
"recipient": {
"first_name": "Joanna",
"last_name": "Doe",
"account_number": "LT121000011101001201",
"account_number_type": "iban",
"address": {
"address_line1": "978 First St",// Only for the recipients from USA and Canada
"city": "Denver",// Only for the recipients from USA and Canada
"state": "CO",// Only for the recipients from USA and Canada
"country": "US"
}
}
}
}
}
Example of the AFT request for SH integration option
{
"request": {
"amount": 100,
"currency": "USD",
"description": "Test transaction",
"tracking_id": "your_uniq_number",
"language": "en",
"test": true,
"credit_card": {
"number": "4200000000000000",
"verification_value": "123",
"holder": "John Doe",
"exp_month": "05",
"exp_year": "2027"
},
"customer": {
"birth_date": "1980-01-01" //Recipient's date of birth, required if the Merchant
//Category Code (MCC) is 6012 AND the merchant's country is UK
},
"billing_address": {//Sender's data, the object is required if sender ≠ recipient
"first_name": "Bill",
"last_name": "Johnshon",
"address": "First Str. 2",
"city": "New York",
"state": "NY",
"country": "US"
},
"additional_data": {
"recipient": {
"first_name": "Joanna",
"last_name": "Doe",
"account_number": "LT121", // Required if the Merchant
//Category Code (MCC) 6012 AND the merchant's country is UK
"address": {
"address_line1": "978 First St", // Required if recipient=sender
//or if the recipient's country is Canada (CA), USA (US), Colombia (CO) or Nicaragua (NI)
"city": "Denver", // Required if recipient=sender
// or if the recipient's country is Canada (CA), USA (US), Colombia (CO) or Nicaragua (NI)
"state": "CO",
"country": "US",// Required
"zip": "SW1A 1AA" // Required if the merchant's country is UK
}
},
"funding_type": "01", // Optionally specified if the recipient's country is US
"customer_id_data": {
"id_value": "1980-01-02"// Sender's date of birth, required
}
}
}
}
Example of the request with information about ticket and tour voucher sale
{
"request":{
"amount":100,
"currency":"USD",
"description":"Test transaction",
"tracking_id":"your_uniq_number",
"test":true,
"billing_address":{
"first_name":"John",
"last_name":"Doe",
"country":"US",
"city":"Denver",
"state":"CO",
"zip":"96002",
"address":"1st Street"
},
"credit_card":{
"token":"40bd001563085fc35165329ea1ff5c5ecbdbbeef40bd001563085fc35165329e"
},
"customer":{
"ip":"127.0.0.1",
"email":"[email protected]"
},
"travel": {
"airline": {
"agency_code": "03",
"agency_name": "Corel travel",
"ticket_number": "390 5241 025377 1",
"booking_number": "DKZVUA",
"restricted_ticket_indicator": "0",
"legs": [
{
"airline_code": "B2",
"stop_over_code": "X",
"flight_number": "A3 971",
"departure_date_time": "2014-05-26T05:15:00",
"arrival_date_time": "2014-05-26T07:30:00",
"originating_country": "RU",
"originating_city": "Moscow",
"originating_airport_code": "DME",
"destination_country": "Greece",
"destination_city": "Athens",
"destination_airport_code": "ATH",
"coupon": "coupon code",
"class": "C"
}
],
"passengers":[
{
"first_name": "KONSTANTIN",
"last_name": "IVANOV"
},
{
"first_name": "JULIA",
"last_name": "IVANOVA"
}
]
}
}
}
}
Response
In the transaction section response parameters replicate request parameters except the additional ones:
Example of the response
Example of the response with incomplete 3-D Secure verification
|