Card Payment - Prepare 3D Form (new card)

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

client-id

string

optional

Default:

302382-1928283273-237723829-292999

Body Params application/json

journeyId

string

required

alias

string

required

payment

object

required

installment

integer

required

cardHolder

string

required

cardNumber

string

required

cardExpiry

string

required

cardCvv

string

required

saveCard

boolean

required

invoice

object

required

isCorporate

boolean

required

invoiceName

string

required

address

string

required

district

string

required

zipcode

string

required

city

string

required

country

string

required

taxOffice

string

required

taxNumber

string

required

Example

{
    "journeyId": "{{journeyId}}",
    "alias": "{{paymentType}}",
    "payment": {
        "installment": 1,
        "cardHolder": "John Due",
        "cardNumber": "4048095010857528",
        "cardExpiry": "05/28",
        "cardCvv": "000",
        "saveCard": false
    },
    "invoice": {
        "isCorporate": true,
        "invoiceName": "Sekiz Kreatif",
        "address": "Test mah",
        "district": "Cad.",
        "zipcode": "58060",
        "city": "İstanbul",
        "country": "Türkiye",
        "taxOffice": "Avcılar",
        "taxNumber": "7590477978"
    }
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://test-api.ucuzyolu.com/pay/card/prepare' \
--header 'client-id: 302382-1928283273-237723829-292999' \
--header 'Content-Type: application/json' \
--data-raw '{
    "journeyId": "",
    "alias": "",
    "payment": {
        "installment": 1,
        "cardHolder": "John Due",
        "cardNumber": "4048095010857528",
        "cardExpiry": "05/28",
        "cardCvv": "000",
        "saveCard": false
    },
    "invoice": {
        "isCorporate": true,
        "invoiceName": "Sekiz Kreatif",
        "address": "Test mah",
        "district": "Cad.",
        "zipcode": "58060",
        "city": "İstanbul",
        "country": "Türkiye",
        "taxOffice": "Avcılar",
        "taxNumber": "7590477978"
    }
}'

Responses

🟢200OK

application/json

Body

data

object

required

id

integer

required

token

string

required

summary

number

required

total

number

required

status

string

required

payment

object

required

invoice

object

required

items

object

required

currencyCode

string

required

paymentCost

integer

required

statusName

string

required

redirectUrl

string

required

is3d

boolean

required

success

boolean

required

code

integer

required

message

string

required

Example

{
    "data": {
        "id": 19,
        "token": "O36RlrouEA6dNAvYFQ8Y3YQqiyZLTd9GNcIi",
        "summary": 1142.78,
        "total": 1142.78,
        "status": "new",
        "payment": {
            "token": "KqmLs8VdJOoHXMeEcmFPXbHqjIyqR6VM3LS47425yR6hKf9EcFwpXFqXGUEcBg3529CitrZpde69Sf1wXyHbTKs7ln27TX4NtZZsMxEEELz3obmB7GthKNaMGmek5GCs",
            "amount": 1142.78,
            "state": "new",
            "comission": 0,
            "total": 1142.78,
            "details": {
                "cardExpiry": "05/28",
                "cardHolder": "John Due",
                "cardNumber": "404809******7528",
                "customerIp": "192.168.65.1",
                "cardAssociation": "Visa"
            },
            "paymentType": "Parolapara POS",
            "is3d": true,
            "authMode": "preauth"
        },
        "invoice": {
            "address": "Test mah",
            "district": "Cad.",
            "zipcode": "58060",
            "city": "İstanbul",
            "country": "Türkiye",
            "isCorporate": true,
            "invoiceName": "Sekiz Kreatif",
            "taxOffice": "Avcılar",
            "taxNumber": "7590477978",
            "invoiceNumber": null
        },
        "items": {
            "flights": [
                {
                    "id": 17,
                    "pnr": "VHMNTY",
                    "refundable": false,
                    "domestic": false,
                    "duration": "01:10",
                    "yr": 149,
                    "vq": 113.17,
                    "date": "2024-10-10",
                    "origin": "IST",
                    "destination": "ESB",
                    "segments": [
                        {
                            "origin": "IST",
                            "destination": "ESB",
                            "date": "2024-10-10",
                            "airline": "TK",
                            "cabin": "T",
                            "price": 871.61,
                            "tax": 262.17,
                            "total": 1139.78,
                            "margin": 3,
                            "returnDate": null,
                            "flightNumber": "TK2192",
                            "cabinClass": "economy",
                            "currencyCode": "TRY",
                            "grandTotal": 1142.78,
                            "originName": "Atatürk Havalimanı",
                            "destinationName": "Esenboğa Havalimanı",
                            "airlineName": "Turkish Airlines",
                            "originCity": "Istanbul",
                            "destinationCity": "Ankara",
                            "arrivalTime": "03:10",
                            "departureTime": "02:00"
                        }
                    ],
                    "passengers": [
                        {
                            "id": 22,
                            "status": 0,
                            "pnr": "VHMNTY",
                            "gender": "M",
                            "birthdate": "1989-04-20",
                            "email": "JOHNDUE@EXAMPLE.COM",
                            "identity": "49852133948",
                            "nationality": "TR",
                            "phone": "+905322808035",
                            "total": 1136.78,
                            "sequenceNo": 1,
                            "ticketNumber": null,
                            "firstName": "MEHMET",
                            "lastName": "GULBILGE",
                            "isLocalCitizen": true,
                            "passportCountry": null,
                            "passportNo": null,
                            "passportValidDate": null,
                            "paxCode": "ADT",
                            "priceHandLuggage": 0,
                            "priceBaggage": 0
                        }
                    ],
                    "sequenceNo": 0,
                    "flightId": "44b413ef-4012-40ac-a72a-d9702d933429",
                    "passengerCount": 1,
                    "flightType": "oneway",
                    "grandTotal": 1142.78,
                    "airDuration": "01:10",
                    "originCity": "Istanbul",
                    "originName": "Atatürk Havalimanı",
                    "returnDate": null,
                    "arrivalTime": "03:10",
                    "departureTime": "02:00",
                    "destinationCity": "Ankara",
                    "destinationName": "Esenboğa Havalimanı"
                }
            ]
        },
        "currencyCode": "TRY",
        "paymentCost": 0,
        "statusName": "Taslak",
        "redirectUrl": "http://pay.tripingram.local/card/fo303VTr4OAsI6p3JZq8djg0TBjnjf9lVB95FBCNqD8ISbbV5T8BiUFEwqSbEsQfBLKo8JhZqTVOysCkghalku1ItUlaYwp88P1A6KhQWMZc7KN6CRo2yzfARDIStaun/redirect",
        "is3d": true
    },
    "success": true,
    "code": 0,
    "message": ""
}