Create Payment Request

POST https://uygulama.vomsis.com/api/vpos/v3/request-payment

Bu servis ile gönderilen istek parametreleri ile bir ödeme talebi (payment link) oluşturulur.

Headers

Field	Type	Description
`Authorization`	String	Zorunlu. `Bearer {access_token}` formatında gönderilmelidir.

Request Parameters

Field	Type	Required	Description
`title`	String	Opsiyonel	Tahsilat başlığı. Girilmezse `Yeni Ödeme` değeri verilir.
`amount`	String	Zorunlu	Tutar 0’dan büyük olmalı. Örnek: `"10.50"`
`expire_date`	String	Opsiyonel	Talebin geçerli olacağı son tarih. Format: `dd.mm.yyyy`. Boş bırakılırsa 3 ay sonrası kabul edilir.
`email`	String	Opsiyonel	E-posta gönderilecek müşteriye ait mail adresi.
`phone`	String	Opsiyonel	SMS gönderilecek müşteriye ait telefon numarası. Örnek: `05551234567`
`sms_notification`	Boolean	Opsiyonel	`true` gönderilirse müşteriye SMS bildirimi yapılır.
`mail_notification`	Boolean	Opsiyonel	`true` gönderilirse müşteriye e-posta bildirimi yapılır.
`lang`	String	Opsiyonel	Bildirim metinlerinin dili. Alabileceği değerler: `en`, `de`, `it`, `es`, `tr`. Varsayılan: `tr`.
`max_installments`	Integer	Opsiyonel	Ödeme linkinde izin verilecek maksimum taksit sayısı. Varsayılan: `0` (Taksit yok).
`currency`	String	Opsiyonel	Para birimi. Alabileceği değerler: `TRY`, `USD`, `EUR`. Varsayılan: `TRY`.
`inputs`	Object	Opsiyonel	Ödeme talebi formunda müşteriden toplanacak ek dinamik alanları içerir.

Detaylı `inputs` Yapısı

Bu alanda, ödeme formu üzerinde müşteriden toplanacak fatura veya ek iletişim bilgileri gibi alanları dinamik olarak yönetebilirsiniz. Her bir alan (infoEmails, description, nameSurname vb.) kendi içinde ayarlar içeren bir nesnedir.

value (String): Alana önceden doldurulmuş olarak gelecek varsayılan değer.
show (String): Alanın ödeme formunda görünüp ("true") görünmeyeceğini ("false") belirler.
changable (String): Müşterinin bu alanı değiştirip ("true") değiştiremeyeceğini ("false") belirler.
required (String): Müşterinin bu alanı doldurmasının zorunlu ("true") olup olmadığını ("false") belirler.

`invoiceType` Kullanımı

inputs içerisinde gönderilen invoiceType alanı, toplanacak fatura bilgilerinin yapısını belirler:

individual (Bireysel): Müşterinin T.C. kimlik numarası, ad soyad gibi kişisel bilgileri istenir.
commercial (Kurumsal): Müşterinin şirket ünvanı, vergi dairesi, vergi numarası gibi kurumsal bilgileri istenir.

Örnek İstekler (Request Examples)

Temel Örnek (Basic)

{
  "title": "Yeni Fatura Ödemesi",
  "amount": "10.00",
  "expire_date": "12.12.2025",
  "email": "example@domain.com",
  "phone": "05555555555",
  "sms_notification": true,
  "mail_notification": true,
  "lang": "tr",
  "max_installments": 2,
  "currency": "TRY"
}

Headers​

Request Parameters​

Detaylı inputs Yapısı​

invoiceType Kullanımı​

Örnek İstekler (Request Examples)​

Temel Örnek (Basic)​