1. API Dökümanı
  • Hızlı Başlangıç
    • Giriş
    • Ürün Özeti
    • Ödeme yaşam döngüsü
    • İade mantığı
    • Webhook ve bildirimler
    • Hata yönetimi
    • Güvenlik özeti
    • Entegrasyon mantığı
    • Sık sorulan sorular
  • Geliştiriciler
    • API referansı
    • İstek / Yanıt içeriği
    • Kimlik ve ortamlar
    • Webhook teknik ayrıntılar
    • Finekstra LLM / Kod asistanı
  • API Dökümanı
    • Çıkış IP bilgisi
      GET
    • Servis sağlık kontrolü
      GET
    • Ödeme başlat
      POST
    • Ön provizyon başlat
      POST
    • Ödeme linki oluştur
      POST
    • İşlem durumu sorgula
      GET
    • İşlem listesi sorgula
      GET
    • Ön provizyonu tahsil et
      POST
    • İade talebi oluştur
      POST
  1. API Dökümanı

Ödeme başlat

Testing Env
https://api-sandbox.finekstra.com
Testing Env
https://api-sandbox.finekstra.com
POST
https://api-sandbox.finekstra.com
/payment/initialize
Kart ile doğrudan tahsilat başlatır. Tutar minor birimdedir (kuruş).

Request

Authorization
API Key
Add parameter in header
X-API-KEY
Example:
X-API-KEY: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Successful Response
Body

🟠422
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-sandbox.finekstra.com/payment/initialize' \
--header 'X-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "locale": "tr",
    "currency": "string",
    "amount": 1,
    "buyer_cost": 0,
    "reference_no": "string",
    "is3d": true,
    "installment": 1,
    "card_details": {
        "card_number": "stringstrings",
        "expire_month": 0,
        "expire_year": 0,
        "cvv": 0
    },
    "customer_info": {
        "name": "string",
        "surname": "string",
        "email": "string",
        "phone": "string",
        "ip_address": "string"
    },
    "billing_info": {
        "name": "string",
        "surname": "string",
        "company": "string",
        "phone": "string",
        "address": "string",
        "country": "TR",
        "city": "string",
        "postalCode": "string",
        "tckn_vkn": "stringstri"
    },
    "shipping_info": {
        "name": "string",
        "surname": "string",
        "company": "string",
        "phone": "string",
        "address": "string",
        "country": "TR",
        "city": "string",
        "postalCode": "string",
        "tckn_vkn": "stringstri"
    },
    "basket_items": [
        {
            "item_id": "string",
            "title": "string",
            "category": "string",
            "kind": "PHYSICAL",
            "quantity": 1,
            "unit_price": 0,
            "total_price": 0
        }
    ],
    "callback_url": "",
    "description": "string",
    "statement_descriptor": "string"
}'
Response Response Example
200 - Example 1
{
    "success": true,
    "data": null,
    "error": {
        "code": "string",
        "message": "string",
        "http_status": 0,
        "user_message": "string",
        "field_errors": {
            "property1": "string",
            "property2": "string"
        },
        "details": {}
    },
    "meta": {}
}
Previous
Servis sağlık kontrolü
Next
Ön provizyon başlat
Built with