Api ile Ödeme Linki Oluşturma
Bu endpoint, dinamik ödeme linkleri oluşturmanızı sağlar. Linkler tek veya çok kullanımlık olabilir ve SMS/e-posta ile otomatik olarak müşteriye iletilebilir.
Kimlik doğrulama bilgileri (PublicKey, Nonce, Signature, ConversationId, MerchantNumber) header olarak iletilir.
Önemli Parametreler
linkType
| Değer | Açıklama |
|---|---|
SingleUse | Link yalnızca bir kez kullanılabilir |
MultipleUse | Link birden fazla kez kullanılabilir. maxUsageCount ile sınırlanır. |
linkAmountType
| Değer | Açıklama |
|---|---|
FixedAmount | Sabit tutar. amount alanı zorunludur. |
VariableAmount | Müşteri ödeme sırasında tutarı kendisi girer. |
notificationMethod
| Değer | Açıklama |
|---|---|
None | Bildirim gönderilmez |
Sms | SMS ile gönderilir. smsTo alanı zorunludur. |
Email | E-posta ile gönderilir. emailTo alanı zorunludur. |
Both | Hem SMS hem e-posta ile gönderilir. |
currency
Para birimi kodu (ISO 4217 numerik): 949 = TRY
Örnek İstek
POST /v1/Payments/createLink
Content-Type: application/json
PublicKey: your-public-key
Nonce: 1770629965755
Signature: dZspDJX18zdC1MnX4d0mhIX0F3IitK0+DQb5ZyxqR3U=
ConversationId: conv-001
MerchantNumber: 000001
{
"linkType": "SingleUse",
"expiryDate": "2026-03-01T23:59:59",
"maxUsageCount": 1,
"linkAmountType": "FixedAmount",
"amount": 100.00,
"currency": 949,
"installments": [1, 3, 6],
"commissionFromCustomer": false,
"is3dRequired": true,
"productName": "Test Ürün",
"productDescription": "Test ürün açıklaması",
"returnUrl": "https://yoursite.com/payment-result",
"isNameRequired": true,
"isEmailRequired": true,
"isPhoneNumberRequired": false,
"isAddressRequired": false,
"isNoteRequired": false,
"notificationMethod": "Email",
"emailTo": ["musteri@example.com"]
}{
"id": "e9080614-2223-441f-a542-1acbec185d37",
"isSuccess": true,
"linkUrl": "https://pos.rubikpara.com/SRAQTzuI"
}Dönen id değerini saklayın. Link silme ve durum sorgulama işlemlerinde bu değer kullanılır.
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
merchantId?string
Format
uuidlinkType?string
Value in
"SingleUse" | "MultipleUse"expiryDate?string
Format
date-timemaxUsageCount?integer
Format
int32orderId?|
linkAmountType?string
Value in
"FixedAmount" | "VariableAmount"amount?number
Format
doublecurrency?integer
Format
int32installments?array<>|
commissionFromCustomer?boolean
is3dRequired?boolean
productName?|
productDescription?|
returnUrl?|
isNameRequired?boolean
isEmailRequired?boolean
isPhoneNumberRequired?boolean
isAddressRequired?boolean
isNoteRequired?boolean
notificationMethod?string
Value in
"None" | "Sms" | "Email" | "Both"smsTo?array<>|
emailTo?array<>|
commissionFromCustomerSingleInstallment?boolean
[key: string]?never
Response Body
application/json
curl -X POST "https://testpfapi.rubikpara.com/v1/Payments/createLink" \ -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 '{}'{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"isSuccess": true,
"linkUrl": "string"
}