Create Payment Request

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

Bu servis ile gönderilen istek paremetreleri ile ödeme talebi oluşturulur.

Headers

Request Parameters

inputs:
Bu alanda ek olarak gönderilecek fatura veya iletişim bilgileri gibi bilgilerin detaylandırılmasını sağlayan dinamik alanlar yer alır.

Her alt anahtar, form üzerinde nasıl görüntüleneceğini ve kullanıcının müdahalesine (değiştirilebilir olup olmadığı, zorunluluk durumu vb.) dair ayarları içerir.

• show: Bu özellik, ilgili alanın kullanıcı arayüzünde görünüp görünmeyeceğini belirler.
  Örnek: "true" değeri alanın ekranda gösterileceğini, "false" ise gizleneceğini ifade eder.
• changable: Bu özellik, kullanıcının ilgili alanın değerini değiştirme yetkisine sahip olup olmadığını kontrol eder.
  Örnek: "true" değeri, kullanıcının alanı düzenleyebileceğini; "false" değeri alanın salt okunur olduğunu belirtir.
• required: Bu özellik, alanın doldurulmasının zorunlu olup olmadığını belirtir.
  Örnek: "true" değeri alanın doldurulmasının zorunlu olduğunu, "false" değeri ise isteğe bağlı olduğunu gösterir.

Bu dinamik ayarlarla, ödeme formu üzerindeki ek alanların görünürlüğü, düzenlenebilirliği ve zorunluluk durumu, uygulamanın ihtiyaçlarına göre özelleştirilebilir hale gelir.

Request Example (basic)

{
  "title": "ödeme test",
  "amount": "10",
  "expire_date": "12.12.2025",
  "email": "example@domain.com",
  "phone": "05555555555",
  "sms_notification": true,
  "mail_notification": true,
  "lang": "tr",
  "max_installments": 2,
  "currency": "TRY",
}                    
 

Request Example (detailed) içerisindeki invoiceType: Bu alan, gönderilecek fatura bilgilerinin yapısını belirler.

Bireysel (individual):
Müşterinin kimlik bilgileri (örneğin: ad soyad, e-posta, telefon, adres, T.C. kimlik numarası veya vergi numarası) gönderilir.
Bu durumda, fatura için kişisel bilgiler kullanılır.

Kurumsal (commercial):
Şirket bilgileri (örneğin: şirket unvanı, vergi dairesi, vergi numarası, e-posta, telefon, adres) gönderilir.
Kurumsal faturalandırmada, bireyselden farklı olarak şirketin resmi bilgileri kullanılır.

Request Example (detailed)

{
    "title": "ödeme test",
    "phone": "05555555555",
    "email": "example@domain.com",
    "amount": "10",
    "currency": "TRY",
    "expire_date": "12.12.2025",
    "max_installments": 2,
    "sms_notification": true,
    "mail_notification": true,
    "lang": "tr",
    "inputs": {
        "infoEmails": {
          "value": "example@domain.com",
          "show": "true",
          "changable": "true",
          "required": "true"
        },
        "description": {
          "show": "true",
          "changable": "true",
          "required": "true"
        },
        "invoiceType": {
          "value": "individual"
        },
        "nameSurname": {
          "value": "John doe",
          "show": "true",
          "changable": "true",
          "required": "false"
        },
        "email": {
          "value": "example@domain.com",
          "show": "true",
          "changable": "true",
          "required": "false"
        },
        "phone": {
          "value": "05555555555",
          "show": "true",
          "changable": "true",
          "required": "false"
        },
        "taxNumber": {
          "value": "12121212",
          "show": "true",
          "changable": "true",
          "required": "false"
        },
        "address": {
          "value": "123 Sample Street, İstanbul",
          "show": "true",
          "changable": "true",
          "required": "false"
        }
    }
}

 

Success Response

{
    "payment_uid": "149b13aa-1ab3-11f0-838a-e9b87fc9797a",
    "success": true,
    "message": "İşlem Başarılı"
}

GET https://uygulama.vomsis.com/api/vpos/v3/request-payment?page=1

{
    "success": true,
    "items": {
      "current_page": 1,
      "data": [
        {
          "uid": "149b13aa-1ab3-11f0-848a-e9b87fc9797a",
          "baslik": "ödeme test",
          "tutar": "10",
          "telefon": "05555555555",
          "gecerlilik_tarihi": "2025-04-08 23:59:59",
          "lang": "tr",
          "inputs": {
            "infoEmails": {
              "value": "example@domain.com",
              "show": "true",
              "changable": "true",
              "required": "true"
            },
            "description": {
              "show": "true",
              "changable": "true",
              "required": "true"
            },
            "invoiceType": {
              "value": "individual"
            },
            "nameSurname": {
              "value": "John Doe",
              "show": "true",
              "changable": "true",
              "required": "false"
            },
            "email": {
              "value": "example@domain.com",
              "show": "true",
              "changable": "true",
              "required": "false"
            },
            "phone": {
              "value": "05555555555",
              "show": "true",
              "changable": "true",
              "required": "false"
            },
            "taxNumber": {
              "value": "12121212",
              "show": "true",
              "changable": "true",
              "required": "false"
            },
            "address": {
              "value": "123 Sample Street, İstanbul",
              "show": "true",
              "changable": "true",
              "required": "false"
            }
        },
        "max_taksit": 2,
        "para_birimi": "TRY",
        "durum": "Beklemede",
        "created_at": "2025-04-21 09:18:53"
    }
}
        ],
        "first_page_url": "https://vomsis.test/api/vpos/v3/payment?page=1",
        "from": 1,
        "last_page": 15,
        "last_page_url": "https://vomsis.test/api/vpos/v3/payment?page=15",
        "next_page_url": "https://vomsis.test/api/vpos/v3/payment?page=2",
        "path": "https://vomsis.test/api/vpos/v3/payment",
        "per_page": 15,
        "prev_page_url": null,
        "to": 15,
        "total": 222
}

                          
                    

DELETE https://uygulama.vomsis.com/api/vpos/v3/request-payment/{uid}

{
    "success": true,
    "message": "Ödeme talebi başarılı bir şekilde silindi." 
}
                    

{
    "success": false,
    "message": "Silinecek ödeme talebi bulunamadı."
}
                    

GET https://uygulama.vomsis.com/api/vpos/v3/request-payment/{uid}

{
    "success": true,
    "requestDetail": {
        "uid": 7f6ce58c-1e78-11f0-ac74-0a00c7465c20,
        "title": "Invoice Payment",
        "status": "Pending",
        "installments": 3,
        "information_email": "example@domain.com",
        "information_phone": "05555555555",
        "email_notification": "Active",
        "sms_notification": "Inactive"
        "payment_info": {
            "link": "https://demotahsilat.odemetahsilat.com/?tuid=418a632e-1f50-11f0-a12c-0a00c7465c20",
            "amount": "10 TRY",
            "expire_date": "30.09.2025",
            "description": "note",
            "created_date": "01.03.2025 12:00:00"            
        }
    }
}