Official Api

Card Payment - Prepare 3D Form (new card)

Developing

POST

https://test-api.ucuzyolu.com/pay/card/prepare

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

cardToken

string

required

cardCvv

string

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,
    "cardToken": "{{savedToken}}",
    "cardCvv": "000"
  },
  "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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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,
        "cardToken": "",
        "cardCvv": "000"
    },
    "invoice": {
        "isCorporate": true,
        "invoiceName": "Sekiz Kreatif",
        "address": "Test mah",
        "district": "Cad.",
        "zipcode": "58060",
        "city": "İstanbul",
        "country": "Türkiye",
        "taxOffice": "Avcılar",
        "taxNumber": "7590477978"
    }
}'

Responses

🟢200Success

application/json

Body

data

object

required

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": ""
}

Modified at 2024-10-07 18:43:44

Card Payment - Bin Query

Card Payment - Check Status