1. Ödeme Başlat

Toplu ödeme yöntemi kapsamında ödeme başlatmak için bu servisi kullanabilirsiniz. Bu servis ile ödeme emirlerinizi Paywall'a gönderebilirsiniz. Ödemelerinizi tamamlayacak ve geri bildirim gönderilecek

Ödeme Başlat

POST {{Base Adres}}/api/paywall/payment/bulk/startdirect

Önemli: Toplu ödeme başlatma servisini kullanabilmeniz için Header alanında apikeypublic ve apiclientpublic parametrelerini göndermeniz gerekmektedir. PaymentAPI Adresi

Parametre
Tip
Zorunlu
Açıklama

apikeypublic

string

Evet

Üye işyeri panelinden temin etmiş olduğunuz Public Key.

apiclientpublic

string

Evet

Üye işyeri panelinden temin etmiş olduğunuz Public Client.

Servise gönderilecek örnek JSON ve örnek kodlar aşağıdaki gibidir.

{
    "PaymentDetail": {
        "Amount": 4.53,
        "MerchantUniqueCode": "{{$guid}}",
        "CurrencyId": 1,
        "Installement": 2,
        "CallbackAddress": "https://webhook.site/fdd9d71c-4381-481f-abf4-2fba544f8a2d",
        "ChannelId": 0,
        "TagId": 0,
        "ClientIP": "1.1.1.1",
        "Half2D": false
    },
    "CardMethod": 2, // 1: General card for all products | 2: Single card for each product
    // Eğer 1 gelirse aşağıdaki kart nesnesi
    "CardModel": 1, // 1: ECommerce | 2: Insurance
    "Payments": [
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "enes@paywall.one",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "IdentityNumber",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "1",
                "ProductName": "12",
                "ProductCategory": "1",
                "ProductDescription": "denemr",
                "ProductAmount": 1.51
            },
            "Card": {
                "OwnerName": "Enes Tütüncü",
                "Number": "5528790000000008",
                "IdentityNumber": "",
                "ExpireMonth": "12",
                "ExpireYear": "2030",
                "Cvv": "123"
            }
        }
    ]
}

Ana Dizin

Parametre
Tip
Zorunlu
Açıklama

PaymentDetail

json

Evet

Ödeme detaylarının konumlandırılacağı Json nesnesidir

CardMethod

int

Evet

CardModel

int

Evet

Payments

List<Payment>

Evet

Toplu ödeme kapsamında alınacak olan ödemelerin yer aldığı liste şeklinde Json nesnesidir

Ana Dizin: PaymentDetail

Parametre
Tip
Zorunlu
Açıklama

Amount

string

Evet

Ödeme işleminde tahsil edilecek toplam tutardır.

MerchantUniqueCode

decimal

Evet

Üye işyerine özgü olarak tanımlanan benzersiz bir koddur.

CurrencyId

string

Evet

Installement

integer

Evet

Müşterinin ödeme planında seçtiği taksit adedini gösterir.

CallbackAddress

string

Evet

İşlem tamamlandıktan sonra sistemin sonuç bilgisini ileteceği adrestir.

ChannelId

integer

Hayır

TagId

integer

Hayır

İlgili işlem veya ürüne özel etiket kimliğidir.

ClientIP

string

Evet

İşlem yapan kullanıcının IP adresini ifade eder.

Half2D

bool

Hayır

Ödemelerinizi özel bir çağrı ile finansallaştırabilmeniz için size destek olacak parametredir. Half2D parametresini true göndermeniz durumunda ödeme bitirme çağrısını siz yapana kadar ödemeniz bankada provizyonda kalacaktır.

Ana Dizin: Payments

Parametre
Tip
Zorunlu
Açıklama

Customer > FullName

string

Evet

Müşteri tam adı

Customer > Phone

string

Evet

Müşteri telefon numarası

Customer > Email

string

Evet

Müşteri e-posta adresi

Customer > Country

string

Evet

Müşteri ülkesi

Customer > City

string

Evet

Müşteri şehir bilgisi

Customer > Address

string

Hayır

Müşteri adres bilgisi

Customer > IdentityNumber

string

Hayır

Müşteri kimlik bilgisi

Customer > TaxNumber

string

Hayır

Müşteri vergi no bilgisi

Product > ProductId

string

Evet

Satışı gerçekleşen ürün kimlik bilgisi

Product > ProductName

string

Evet

Satışı gerçekleşen ürün adı

Product > ProductCategory

string

Evet

Satışı gerçekleşen ürünün kategori bilgisi

Product > ProductDescription

string

Hayır

Satışı gerçekleşen ürünün açıklama bilgisi

Product > ProductAmount

decimal

Evet

Satışı gerçekleşen ürünün tutar bilgisi Not: Tüm ürünlerin tutar bilgilerinin toplamı ana tutara eşit olmalıdır

Card > OwnerName

string

Koşullu

Kart sahibi adı

Card > Number

string

Koşullu

Kart numarası

Card > IdentityNumber

string

Koşullu

Kart sahibi kimlik bilgisi

Card > ExpireMonth

string

Koşullu

Kartın son kullanım ay bilgisi

Card > ExpireYear

string

Koşullu

Kartın son kullanım yıl bilgisi

Card > Cvv

string

Koşullu

Kartın CVV bilgisi

Servisten dönen cevap:

Parametre
Tip
Açıklama

ErrorCode

int

Hata kodu. İşlem başarılı ise '0' değerini döner.

Result

bool

İşlem başarılı ise true, hatalı ise false döner.

Message

string

İşlemle ilgili bilgi veya hata mesajını içerir.

Body

nesne

Toplu ödeme işlemine ait detaylı bilgiler.

Örnek Kod:

{
    "ErrorCodeType": 1,
    "ErrorMessage": null,
    "ErrorCode": 0,
    "Result": true,
    "Message": "Bulk payment created and enqueued",
    "Body": {
        "BulkPaymentId": 384,
        "MerchantUniqueCode": "4311df48-a5b0-44ff-bd32-7774a3701dae",
        "Payments": [
            {
                "PaymentId": 2096329,
                "UniqueCode": "59f9551e-1248-4dfa-9cd2-dc321d357b87",
                "MerchantUniqueCode": "24a9ad2e-315d-44d1-9c7c-e03f9d8bd881"
            },
            {
                "PaymentId": 2096330,
                "UniqueCode": "32a781c6-5158-4752-9ecf-cdab09a8bf28",
                "MerchantUniqueCode": "6b276a5f-fbaa-4cca-8e75-032e8bc6509a"
            },
            {
                "PaymentId": 2096331,
                "UniqueCode": "c5031f5d-0cfc-4cd4-be19-1f762eaed591",
                "MerchantUniqueCode": "f31039e8-b124-4c4d-a05b-cca7bc94efeb"
            }
        ]
    }
}
Previous18. Toplu Ödeme YöntemiNext2. Ödeme Sorgula

Last updated