Ödeme (Provizyon)

Bu endpoint, daha önce oluşturulmuş cardToken bilgisi ile ödeme (provizyon) işlemi gerçekleştirmek için kullanılır. Hem 3D Secure'lu hem de 3D Secure'suz (Non-Secure) ödeme akışlarını destekler.

3D Secure ile ödeme: 3DS doğrulaması tamamlandıktan sonra threeDSessionId parametresi set edilerek çağrılır.
3D Secure'suz ödeme: threeDSessionId gönderilmez veya boş bırakılır. Doğrudan cardToken ile ödeme alınır.

Bu endpoint'e JSON body ile istek gönderilir. Kimlik doğrulama bilgileri (PublicKey, Nonce, Signature, ConversationId, MerchantNumber) header olarak iletilir.

Bu servisten dönen orderId değerini mutlaka saklayın. İptal (Reverse), iade (Return) ve sorgulama (Inquire) işlemlerinde bu değer kullanılır.

Ön Koşullar

Bu endpoint'i çağırmadan önce aşağıdaki adımların tamamlanmış olması gerekir:

Kimlik doğrulama değerlerini hazırlayın — PublicKey, Nonce, Signature ve ConversationId değerlerini oluşturun. Test ortamında Test İmzası Oluştur endpoint'ini kullanabilirsiniz.
Kart tokenize edin — /v1/Tokens endpoint'inden cardToken değerini alın.
3D Secure (opsiyonel) — 3D Secure ile ödeme yapılacaksa 3DS oturum oluştur → 3DS başlat → 3DS sonuç sorgula adımlarını tamamlayıp threeDSessionId değerini alın.

API Playground

Header Parameters

PublicKey?string

Nonce?string

Signature?string

ConversationId?string

ClientIpAddress?string

İşlem yapan kullanıcının IP adresi (örn: 192.168.1.1)

MerchantNumber?string

X-Forwarded-For?string

Request Body

application/json

amount?number

Formatdouble

pointAmount?number

Formatdouble

cardToken?|

currency?|

paymentType?string

Value in"Auth" | "PreAuth" | "PostAuth"

integrationMode?string

installmentCount?integer

Formatint32

threeDSessionId?|

originalOrderId?|

languageCode?|

merchantCustomerName?|

merchantCustomerPhoneCode?|

merchantCustomerPhoneNumber?|

description?|

cardHolderName?|

gateway?|

[key: string]?never

Response Body

`application/json`

curl -X POST "https://testpfapi.rubikpara.com/v1/Payments/provision" \  -H "PublicKey: Xu3aI6WHR6geG/I/swR0Lg==" \  -H "Nonce: " \  -H "Signature: " \  -H "ConversationId: test123456" \  -H "ClientIpAddress: 192.168.1.1" \  -H "MerchantNumber: 1100000001" \  -H "Content-Type: application/json" \  -d '{}'

{
  "conversationId": "test123456"
}

Kullanım Örnekleri

POST /v1/Payments/provision
Content-Type: application/json
PublicKey: your-public-key
Nonce: 1770629965755
Signature: dZspDJX18zdC1MnX4d0mhIX0F3IitK0+DQb5ZyxqR3U=
ConversationId: conv-001
MerchantNumber: 000001

{
  "amount": 100.00,
  "pointAmount": 0,
  "cardToken": "w2maVeYtMJeQ8lMeB0RLbzZuHt+H5OWGywvTRphsu5k=",
  "currency": "TRY",
  "paymentType": "Auth",
  "integrationMode": "Api",
  "installmentCount": 1,
  "threeDSessionId": "3ds_session_abc123",
  "languageCode": "tr",
  "cardHolderName": "John Doe"
}

POST /v1/Payments/provision
Content-Type: application/json
PublicKey: your-public-key
Nonce: 1770629965755
Signature: dZspDJX18zdC1MnX4d0mhIX0F3IitK0+DQb5ZyxqR3U=
ConversationId: conv-001
MerchantNumber: 000001

{
  "amount": 100.00,
  "pointAmount": 0,
  "cardToken": "w2maVeYtMJeQ8lMeB0RLbzZuHt+H5OWGywvTRphsu5k=",
  "currency": "TRY",
  "paymentType": "Auth",
  "integrationMode": "Api",
  "installmentCount": 1,
  "languageCode": "tr",
  "cardHolderName": "John Doe"
}

3D Secure'suz ödemede threeDSessionId alanı gönderilmez veya boş bırakılır. Bu yöntem sadece banka/PSP tarafından yetkilendirilmiş üye iş yerleri için aktiftir.

Başarılı Yanıt

{
  "isSucceed": true,
  "errorCode": null,
  "errorMessage": null,
  "conversationId": "conv-001",
  "orderId": "ORD-123456",
  "provisionNumber": "PV-789",
  "description": "Islem basarili",
  "bankResponse": { ... }
}

Önemli Parametreler

paymentType

Değer	Açıklama
`Auth`	Standart satış işlemi. Tutar anında çekilir.
`PreAuth`	Ön provizyon. Tutar bloke edilir, daha sonra `PostAuth` ile çekilir.
`PostAuth`	Ön provizyon kapama. `PreAuth` ile bloke edilen tutarı çeker. `originalOrderId` zorunludur.

integrationMode

Değer	Açıklama
`Api`	Standart API entegrasyonu

currency

Desteklenen para birimi kodları: TRY

Yanıt Alanları

Alan	Tip	Açıklama
`isSucceed`	boolean	İşlemin başarılı olup olmadığı
`errorCode`	string	Hata kodu (başarısız durumda)
`errorMessage`	string	Hata mesajı (başarısız durumda)
`conversationId`	string	İstek takip numarası
`orderId`	string	Sipariş numarası — iptal, iade ve sorgulama işlemlerinde kullanılır
`provisionNumber`	string	Banka provizyon numarası
`description`	string	İşlem açıklaması
`bankResponse`	object	Banka detaylı yanıt bilgileri

200application/json

On this page

`application/json`