1. Storm 🍃
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 (Storm)
POST {{Base Adres}}/api/paywall/payment/bulk/startdirect
Storm🍃 modelinde, 23:50 - 00:00 saatleri arasında gönderilen toplu ödeme talepleri, gece yarısından sonra işlenir. Bu bekleme süresi, finansal raporların tutarlılığını sağlamak amacıyla uygulanmaktadır.
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,
"Installment": 2,
"CallbackAddress": "https://webhook.site/fdd9d71c-4381-481f-abf4-2fba544f8a2d",
"ChannelId": 0,
"TagId": 0,
"ClientIP": "1.1.1.1",
"Half2D": false,
"CallbackBodySplit": false,
"CallbackBodyCompression": 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": "[email protected]",
"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
PaymentDetail
json
Evet
Ödeme detaylarının konumlandırılacağı Json nesnesidir
CardMethod
int
Evet
Ödemeler için kullanılacak kart yöntemi. Bu parametreye bağlı olarak her ödeme tek bir karttan veya her ödeme kendine özel karttan gerçekleşir Tipler
Payments
List<Payment>
Evet
Toplu ödeme kapsamında alınacak olan ödemelerin yer aldığı liste şeklinde Json nesnesidir
Ana Dizin: PaymentDetail
Amount
string
Evet
Ödeme işleminde tahsil edilecek toplam tutardır.
MerchantUniqueCode
decimal
Evet
Üye işyerine özgü olarak tanımlanan benzersiz bir koddur.
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.
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.
CallbackBodySplit
bool
Hayır
Toplu ödeme işlemi bittiğinde gönderilen Post bildirimi, ilgili parametre true gönderildiği durumda, ödeme adedine bağlı olarak parçalı bir şekilde gönderilir.
Örnek: 500 ödeme için parametrenin true gönderilmesi durumda, sistem kendi yoğunluğuna göre bu ödemenin bildirimini 100, 100, 100, 100, 100 şekilde 5 parçada gönderebilir. Bu sadece işlemleri kendi tarafınızda parça parça işleyerek sisteminizi de yormamış olursunuz
CallbackBodyCompression
bool
Hayır
Ödeme isteğinin tamamlanması sonrasında gönderilen Post bildirimi, içerisinde barınan verilerden dolayı büyük bir gövdeye (body) sahip olabilir. Bu durumda CallbackBodyCompression parametresini true gönderirseniz, gönderilen Post bildirimleri GZip ile sıkıştırılarak gönderilir. Bu durumda ilgili GZip gövdeyi (body) kendi tarafınızda çözmeniz ve sonra işlemeniz gerekecektir.
Ana Dizin: Payments
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 > CardNoFirst
string
Koşullu
Kartın ilk 8 hanesi
Card > CardNoLast
string
Koşullu
Kartın son 4 hanesi
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:
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": 2680,
"MerchantUniqueCode": "2195a5f9-1f7e-4902-8140-937da12cdc78",
"Payments": [
{
"PaymentId": 3361273,
"UniqueCode": "e3ee84de-ef1d-4632-892d-05437cbed21c",
"MerchantUniqueCode": "19e4d3b6-ce24-418b-acd8-e613bbeef63e"
},
{
"PaymentId": 3361274,
"UniqueCode": "3c4789fb-31e5-4858-adb9-9af3757856a2",
"MerchantUniqueCode": "33ea1a72-20e9-4383-9c33-bf468ba20eb0"
},
{
"PaymentId": 3361275,
"UniqueCode": "0e07daba-5daf-484f-a3fb-aeec693ed946",
"MerchantUniqueCode": "b40f0ab1-b5a7-4623-8e3f-ea54527110b0"
},
{
"PaymentId": 3361276,
"UniqueCode": "f5f5e242-1787-408f-80bb-364359e5e95d",
"MerchantUniqueCode": "2ee34e93-bdf6-4126-9eb3-02099248dd7c"
},
{
"PaymentId": 3361277,
"UniqueCode": "7944863a-1e3b-4f29-bb27-0c247f2af9b7",
"MerchantUniqueCode": "a467ed06-c914-43a6-8f67-739f3beea825"
},
{
"PaymentId": 3361278,
"UniqueCode": "7d687da5-f32e-4162-ad77-c665f2ae17ac",
"MerchantUniqueCode": "d336e712-13ba-4d88-b197-2ef63d060731"
},
{
"PaymentId": 3361279,
"UniqueCode": "8ee0b993-816c-4858-ae3b-57603153df92",
"MerchantUniqueCode": "5040e296-e02e-43d5-b35d-1ff8bbe8b7e2"
},
{
"PaymentId": 3361280,
"UniqueCode": "da065034-a723-469e-a73f-ded77db820a8",
"MerchantUniqueCode": "1a136239-6022-4138-b659-e51b37d0389f"
},
{
"PaymentId": 3361281,
"UniqueCode": "01ebdfea-50d6-48d0-9673-e5d1834a0f93",
"MerchantUniqueCode": "ca08cc74-ebdf-4569-973b-0efa359bd43e"
},
{
"PaymentId": 3361282,
"UniqueCode": "aa1dc1ab-ec41-4a50-8152-b6ffdb67cedc",
"MerchantUniqueCode": "55d12480-4f55-41b6-8b3b-36eefd22c80c"
},
{
"PaymentId": 3361283,
"UniqueCode": "d84880d5-cfda-41ba-ab3b-9a92a4c67319",
"MerchantUniqueCode": "4c6fe785-d672-4fe9-9cb8-ed4a16ab1a06"
},
{
"PaymentId": 3361284,
"UniqueCode": "0263a353-20da-42b9-83b8-7d7bd40eb17a",
"MerchantUniqueCode": "e50c3d2e-19c7-428a-ad2f-ae7a713d46be"
},
{
"PaymentId": 3361285,
"UniqueCode": "a122e75a-eb27-4927-95c9-7382c17388ad",
"MerchantUniqueCode": "9454fa40-05d7-4454-ab33-823ec52f1f79"
},
{
"PaymentId": 3361286,
"UniqueCode": "26522caf-8fa6-48d0-a141-1522f9a952fa",
"MerchantUniqueCode": "a356f0b0-9c90-4496-804e-f0be0e466946"
},
{
"PaymentId": 3361287,
"UniqueCode": "d59aefce-32e3-4ebd-bfd3-1d43191d9aee",
"MerchantUniqueCode": "f45c6549-5dfc-445e-a251-5e445a55a9eb"
},
{
"PaymentId": 3361288,
"UniqueCode": "e49690a4-5a91-4c82-bd48-7e42cee5a96a",
"MerchantUniqueCode": "57d3b657-da1b-4db0-8d3b-dada0ae71f76"
},
{
"PaymentId": 3361289,
"UniqueCode": "4a2b796f-0255-4e2d-b9e0-0d3897dd05da",
"MerchantUniqueCode": "a75ecba8-a2f0-4034-90e0-abeb499a5b45"
},
{
"PaymentId": 3361290,
"UniqueCode": "51cab0e8-a857-4567-9c58-cb3384cecf7a",
"MerchantUniqueCode": "55f3205f-7eb1-4f5f-8526-17cdad8c3e6c"
},
{
"PaymentId": 3361291,
"UniqueCode": "b64f15bf-cc0a-412c-aaa5-7f1226c72afb",
"MerchantUniqueCode": "e40ba3af-7f08-472e-9ffc-4f148522fe0c"
},
{
"PaymentId": 3361292,
"UniqueCode": "3dfa5a55-129a-42de-ac28-e1010d686c2a",
"MerchantUniqueCode": "dac8cb25-572f-4465-b738-7f5eea72d8a5"
},
{
"PaymentId": 3361293,
"UniqueCode": "9ce8662d-0c2d-467b-b463-37a76da3b2ba",
"MerchantUniqueCode": "10d02b8b-7e17-4394-96d8-39965cdf8aab"
},
{
"PaymentId": 3361294,
"UniqueCode": "3b877252-66eb-4855-b941-8b5f94e639d5",
"MerchantUniqueCode": "55e39480-487b-4891-baf4-7a651f8494bf"
},
{
"PaymentId": 3361295,
"UniqueCode": "55012158-9faa-4e63-bc23-7b440a445f7f",
"MerchantUniqueCode": "d215d4e8-3041-4e98-8e34-ce368a80f70d"
},
{
"PaymentId": 3361296,
"UniqueCode": "3d82aa31-2124-41f3-925a-04333caa6449",
"MerchantUniqueCode": "b8eaa5a5-8abb-4b70-ae60-7fb9597af440"
},
{
"PaymentId": 3361297,
"UniqueCode": "c2d16698-4c35-43d5-addf-95b3f2645a4e",
"MerchantUniqueCode": "97448954-98e5-40c3-b1f3-808e8f346c4f"
},
{
"PaymentId": 3361298,
"UniqueCode": "9fc66f64-5d31-4e7d-9e5b-a5f3aec8934d",
"MerchantUniqueCode": "ae291396-9ac7-42ed-b193-4fe6f3adbd4a"
},
{
"PaymentId": 3361299,
"UniqueCode": "594b771e-a206-490b-99a0-f0e185acb7d4",
"MerchantUniqueCode": "a1741bfb-535c-4298-b18b-98271b912366"
},
{
"PaymentId": 3361300,
"UniqueCode": "b78ac1a9-f5a6-4dd8-b7a5-f60c68d254ed",
"MerchantUniqueCode": "e18fc6e8-1772-47a1-b5e9-8129b6f6b0d1"
},
{
"PaymentId": 3361301,
"UniqueCode": "a949abad-d1f7-4ced-a5a5-345ed2e467ae",
"MerchantUniqueCode": "7f8c7b11-8a58-499a-a253-183a9b5c1865"
},
{
"PaymentId": 3361302,
"UniqueCode": "680dccc7-a7ec-4c6b-86dc-3c06da9abfd0",
"MerchantUniqueCode": "ad56b015-ac17-4061-8761-d5bbed5cbe04"
},
{
"PaymentId": 3361303,
"UniqueCode": "6c68e259-9818-430a-827a-c2f454b7f7a7",
"MerchantUniqueCode": "9bfe04ef-5743-4639-9444-f1ec7af6533d"
},
{
"PaymentId": 3361304,
"UniqueCode": "e97d87d9-08da-46ae-8cc2-6d90c4a7f40f",
"MerchantUniqueCode": "f73c514c-a262-4ade-8dc3-29a7a766e751"
},
{
"PaymentId": 3361305,
"UniqueCode": "146a043a-0f6a-4021-98cd-90deeee66f32",
"MerchantUniqueCode": "f9c4285f-844a-4654-a0b5-9ed072c6a9d8"
},
{
"PaymentId": 3361306,
"UniqueCode": "86f5d264-bdc2-4e41-97ef-5008163f818d",
"MerchantUniqueCode": "1b102c4e-d2e2-40d1-b211-04196a5b14b4"
},
{
"PaymentId": 3361307,
"UniqueCode": "ab60d98a-8d23-4a68-a010-d4f6e4f17558",
"MerchantUniqueCode": "eb2e6f15-3170-43e1-85e8-8e1d4d74138f"
},
{
"PaymentId": 3361308,
"UniqueCode": "11278907-4c7e-488f-8b3c-703f154114a7",
"MerchantUniqueCode": "6eca46c3-0e04-4802-a508-400767858b08"
},
{
"PaymentId": 3361309,
"UniqueCode": "0c45ddc3-f954-4096-bced-d04689755713",
"MerchantUniqueCode": "c5a9604d-cb94-4cb4-9f6f-ad1f04a23875"
},
{
"PaymentId": 3361310,
"UniqueCode": "403ef822-6ae9-44fc-a7ed-dc848c203077",
"MerchantUniqueCode": "e66d2a65-65dd-4909-8581-c7bc3eb4b62a"
},
{
"PaymentId": 3361311,
"UniqueCode": "c82e009e-7a0e-4cc4-a27c-79c1ac1d9ee6",
"MerchantUniqueCode": "cf60a89e-f9d4-4fa5-a32e-efe7ce3b14c8"
},
{
"PaymentId": 3361312,
"UniqueCode": "71895fee-23d5-4320-a933-6e7c95450a84",
"MerchantUniqueCode": "519243e6-d3c8-404d-af91-324e3589d173"
},
{
"PaymentId": 3361313,
"UniqueCode": "0670fd0d-2b06-4327-87d1-dfe15622b59a",
"MerchantUniqueCode": "1b25eb96-ab12-4dce-84a8-e35cff2d19c4"
},
{
"PaymentId": 3361314,
"UniqueCode": "697cafbc-f697-4596-b2e1-47586a5998f4",
"MerchantUniqueCode": "03f184b6-eda3-4b8e-a0c2-21cc76c7b50b"
},
{
"PaymentId": 3361315,
"UniqueCode": "11a345f2-4324-4629-8859-f6a37eb432ad",
"MerchantUniqueCode": "78ec9976-93e3-4d10-973d-4fce4270b75c"
},
{
"PaymentId": 3361316,
"UniqueCode": "c1ea0a5c-592e-4ddb-8931-3949720a7efa",
"MerchantUniqueCode": "2c613261-c36b-463d-929c-9f09c5b03060"
},
{
"PaymentId": 3361317,
"UniqueCode": "d5dd9cbf-8468-4c38-8bbb-cf93e9d260ed",
"MerchantUniqueCode": "a9220829-3baa-47f1-a578-051e404080eb"
},
{
"PaymentId": 3361318,
"UniqueCode": "04b095b3-434c-4b64-90e5-ca3bb3ba748c",
"MerchantUniqueCode": "1e7b4183-84ca-4b2e-a7bf-f0468a7f1f67"
},
{
"PaymentId": 3361319,
"UniqueCode": "ac6067f0-98f7-40f3-8e0f-b259bcb07882",
"MerchantUniqueCode": "af24e8b1-04ba-408e-bf8b-c509f5601aaf"
},
{
"PaymentId": 3361320,
"UniqueCode": "23094538-fe00-464b-a341-5ff9c7d747f6",
"MerchantUniqueCode": "a4734931-5c77-425d-a144-d5eaedd20d20"
},
{
"PaymentId": 3361321,
"UniqueCode": "415f7b77-9027-4755-bfba-2b5f2eaf3a24",
"MerchantUniqueCode": "5b6abda1-c1e5-407c-89c6-d7900d7eefa8"
},
{
"PaymentId": 3361322,
"UniqueCode": "545fe621-63cd-433c-ade5-8d5a44313435",
"MerchantUniqueCode": "353b9f53-1a33-43f2-869e-fdf07a285bc7"
}
]
}
}Last updated