Payinall Entegrasyon Rehberi

Güvenli ve hızlı ödeme çözümleri sunan payinall ile entegrasyon sürecinizi kolayca yönetin. Aşağıdaki başlıklar, sistemin nasıl çalıştığını ve nasıl entegre edileceğini adım adım açıklamaktadır.

Payinall Entegrasyonuna Giriş

Payinall ile ödeme sistemlerinizi hızlı ve güvenli şekilde entegre edin. Bu bölümde entegrasyon sürecinin adımlarını, gerekli teknik gereksinimleri ve dikkat edilmesi gereken noktaları öğreneceksiniz.

API Kullanımı

Payinall API, ödeme işlemlerini otomatikleştirmeniz için size güçlü ve esnek bir altyapı sunar. Bu bölümde API uç noktalarını, parametreleri ve örnek istekleri detaylıca inceleyebilirsiniz.

Test Bilgileri

Geliştirme ve test süreçleri için özel olarak hazırlanmış sanal kart bilgilerini burada bulabilirsiniz. Farklı senaryoları test ederek sisteminizin doğru çalıştığından emin olun.

Payinall Entegrasyonuna Giriş

payinall API, çevrimiçi ödeme kabul eden tüm üye iş yerlerinin kullanabilmesi amacı ile tasarlanmıştır. Tercih edilen sunucu taraflı programlama dilleri ile entegre olabilir. Ayrıca API ile çeşitli sorgular yapılabilmektedir. API'nin kullanılabilmesi için üye iş yerlerine önceden tanımlanmış olan merchantId ve secretKey verilmesi gerekmektedir. merchantId üye iş yerini belirten benzersiz bir numara iken, secretKey sorgulama yapmak için kullanılması gereken benzersiz bir numaradır.

Canlı Ortama Geçiş

  • Olası tüm durumlar için ödeme adımlarınızı Test Bilgileri ile test edin.
  • Sonuç sayfanızın (BackrefUrl) payinall'dan gelen yanıtı yorumlamasına dikkat edin.
  • payinall servislerinden dönebilecek tüm hatalara karşı kodunuzu düzenleyin.

API

Payinall API, çevrimiçi ödeme kabul eden tüm üye iş yerlerinin kullanabilmesi amacıyla tasarlanmıştır. Tercih edilen sunucu taraflı programlama dilleriyle entegre edilebilir. Ayrıca API aracılığıyla çeşitli sorgular yapılabilmektedir. API’nin kullanılabilmesi için üye iş yerlerine önceden tanımlanmış merchantld ve secretKey bilgileri vermektedir. Merchantld, üye iş yerini belirten benzersiz bir numaradır; secretKey ise sorgulama yapmak için kullanılması gereken benzersiz bir anahtardır.

Taksit ve Bin Sorgulama
API Entegrasyonu
3D ile Ödeme

Taksit ve Bin Sorgulama

Bu metot ile kartın ilk 6 hanesini girerek, işlemlere yapılabilecek taksit oranları bilgisine ulaşabilirsiniz. Taksit oranları, kartın bağlı olduğu bankaya bağlı olarak ortaya çıkmaktadır.

API Entegrasyonu

Üye iş yerinin API entegrasyonu için kullandığı ödeme formunda bazı kontrollerin bulunması gerekmektedir. Bu kontroller:

  • Kart numarasının Luhn Algoritmasından geçmesi gerekmektedir.
  • Kartın son kullanma tarihinin geçmemiş olması gerekmektedir.
  • Kart sahibinin isim ve soy ismi bilgilerinin girilmesi gerekmektedir.

Üye iş yerlerine sunulan servisler:

  • 3D ile Ödeme
  • Taksit ve Bin Sorgulama
  • Ödeme Sorgulama
  • Ön Provizyonlu Ödeme

3D ile Ödeme

Bu metot, girilen kart bilgileri ile işleme ait miktarın kartın bakiyesinden çekilmesini sağlamaktadır. Tek çekim ve taksitli çekim seçenekleri ile işlemler gerçekleştirilebilir.

Ödeme Sorgulama

Bu metot ile bir işlemin kayda geçip geçmediği sorgulanır ve işlemin detay bilgilerine ulaşılır.

3D Güvenli Ödeme İşlem Akışı

Taksit ve Bin Sorgulama

Servis Adresleri:

Test Ortam Adresi:
https://payinallpostestapi.erpapay.com/api/payment3d/bin/v1
Gerçek Ortam Adresi:
https://payinallposapi.erpapay.com/api/payment3d/bin/v1

Taksit sorgulama işlemi bir kredi kartı girildiğinde ve kredi kartı anlaşmalı bir taksit programına dahilse, kartın ilk 6 hanesinin kullanılması ile taksit oranları hakkında bilgi vermektedir.

Servise Gönderilmesi Gereken Parametreler:

Parametre İsmi Tip Zorunluluk Açıklama
MerchantId string Evet Üye iş yerine ait benzersiz Id numarası
BinCode string Evet Kartın ilk 6 hanesi
  

Servisten Gelen Yanıta Ait Parametreler:

Parametre İsmi Tip Açıklama
BankCode string Kartın ait olduğu bankanın standard kodu.
BankName string Kartın ait olduğu bankanın adı.
CardBrand string Kartın ait olduğu ödeme kuruluşu.
CardType string Girilen kartın türü.
installment (Installments) number Girilen kart ile yapılabilecek taksit miktarı.
BankName string Kartın ait olduğu bankanın adı.
CardBrand string Kartın ait olduğu ödeme kuruluşu.
CardType string Girilen kartın türü.
  

Servisten Dönen Mesaj Kodları:

MessageCode Açıklama
MessageCode = 00 Başarılı
MessageCode = 7201 Geçersiz MerchantId
  

JSON Request-Response (İstek-Yanıt)

//Request
                                    {
                                        "MerchantId": "5d891bbeea1e5e94b02b266b",
                                        "BinCode": "450803"
                                    }
//Response
                                    {
                                        "SystemTime": 1571813371325,
                                        "Success": true,
                                        "MessageCode": "00",
                                        "Message": "Başarılı",
                                        "UserMessage": "İşleminiz başarıyla gerçekleştirildi.",
                                        "SaleRate": "2.5",
                                        "CardType": "Credit",
                                        "CardBrand": "VISA",
                                        "BankCode": "64",
                                        "BankName": "T. İŞ BANKASI A.Ş.",
                                        "IsInstallment": true,
                                        "Installments": [
                                            {
                                                "installment": 1,
                                                "gatewayId": "5d9fb188e578e039573880b9",
                                                "ccMerchantRateInstallment": "2.5"
                                            },
                                            {
                                                "installment": 2,
                                                "gatewayId": "5d9fb188e578e039573880b9",
                                                "ccMerchantRateInstallment": "4"
                                            },
                                            {
                                                "installment": 3,
                                                "gatewayId": "5d9fb188e578e039573880b9",
                                                "ccMerchantRateInstallment": "5"
                                            },
                                            {
                                                "installment": 6,
                                                "gatewayId": "5d9fb188e578e039573880b9",
                                                "ccMerchantRateInstallment": "8"
                                            },
                                            {
                                                "installment": 9,
                                                "gatewayId": "5d9fb188e578e039573880b9",
                                                "ccMerchantRateInstallment": "12"
                                            },
                                            {
                                                "installment": 12,
                                                "gatewayId": "5d9fb188e578e039573880b9",
                                                "ccMerchantRateInstallment": "15"
                                            }
                                        ]
                                    }
  
//Request
                                    {
                                        "MerchantId": "5db6c40a03dd6ec2358b9c5f",
                                        "BinCode": "469181"
                                    }
//Response
                                    {
                                        "SystemTime": 1641888930572,
                                        "Success": true,
                                        "MessageCode": "00",
                                        "Message": "Başarılı",
                                        "UserMessage": "İşleminiz başarıyla gerçekleştirildi.",
                                        "SaleRate": "4.8",
                                        "CardType": "Credit",
                                        "CardBrand": "VISA",
                                        "BankCode": "146",
                                        "BankName": "ODEA BANK",
                                        "IsInstallment": true,
                                        "Installments": [
                                            {
                                                "installment": 1,
                                                "gatewayId": "602d0bdcb1d2715ef89ada6f",
                                                "_id": "5f5630afabd3ba0705e602b9",
                                                "ccMerchantRateInstallment": "1.13"
                                            },
                                            {
                                                "installment": 2,
                                                "gatewayId": "602d0bdcb1d2715ef89ada6f",
                                                "_id": "5f5630afabd3ba0705e602b8",
                                                "ccMerchantRateInstallment": "1.848"
                                            },
                                            {
                                                "installment": 3,
                                                "gatewayId": "602d0bdcb1d2715ef89ada6f",
                                                "_id": "5f5630afabd3ba0705e602b7",
                                                "ccMerchantRateInstallment": "2.3205"
                                            },
                                            {
                                                "installment": 4,
                                                "gatewayId": "602d0bdcb1d2715ef89ada6f",
                                                "_id": "5f5630afabd3ba0705e602b6",
                                                "ccMerchantRateInstallment": "2.793"
                                            },
                                            {
                                                "installment": 5,
                                                "gatewayId": "602d0bdcb1d2715ef89ada6f",
                                                "_id": "5f5630afabd3ba0705e602b5",
                                                "ccMerchantRateInstallment": "3.2655"
                                            },
                                            {
                                                "installment": 6,
                                                "gatewayId": "602d0bdcb1d2715ef89ada6f",
                                                "_id": "5f5630afabd3ba0705e602b4",
                                                "ccMerchantRateInstallment": "3.738"
                                            },
                                            {
                                                "installment": 7,
                                                "gatewayId": "602d0bdcb1d2715ef89ada6f",
                                                "_id": "5f5630afabd3ba0705e602b3",
                                                "ccMerchantRateInstallment": "4.2105"
                                            },
                                            {
                                                "installment": 8,
                                                "gatewayId": "602d0bdcb1d2715ef89ada6f",
                                                "_id": "5f5630afabd3ba0705e602b2",
                                                "ccMerchantRateInstallment": "4.683"
                                            },
                                            {
                                                "installment": 9,
                                                "gatewayId": "602d0bdcb1d2715ef89ada6f",
                                                "_id": "5f5630afabd3ba0705e602b1",
                                                "ccMerchantRateInstallment": "5.1555"
                                            },
                                            {
                                                "installment": 10,
                                                "gatewayId": "602d0bdcb1d2715ef89ada6f",
                                                "_id": "5f5630afabd3ba0705e602b0",
                                                "ccMerchantRateInstallment": "5.628"
                                            },
                                            {
                                                "installment": 11,
                                                "gatewayId": "602d0bdcb1d2715ef89ada6f",
                                                "_id": "5f5630afabd3ba0705e602af",
                                                "ccMerchantRateInstallment": "6.1005"
                                            },
                                            {
                                                "installment": 12,
                                                "gatewayId": "602d0bdcb1d2715ef89ada6f",
                                                "_id": "5f5630afabd3ba0705e602ae",
                                                "ccMerchantRateInstallment": "6.573"
                                            }
                                        ]
                                    }
  

3D İle Ödeme

3D ile ödeme işlemi bir kart ve tutar girildiğinde, girilen tutarın söz konusu kartın bakiyesinden düşürülmesini içerir. Eğer kart bilgileri geçerliyse 3D ile ödeme işlemi tek çekim ve taksitli çekim işlemlerine uygundur.

3D ile ödeme API ile üç aşamada yapılır.

1-Ödeme Bilgilerini Gönderme

Servis Adresi:

Test Ortam Adresi:
https://payinallpostestapi.erpapay.com/api/payment3d/secure3D/v1
Gerçek Ortam Adresi:
https://payinallposapi.erpapay.com/api/payment3d/secure3D/v1

Servise Gönderilmesi Gereken Parametreler:

Parametre İsmi Tip Zorunluluk Açıklama
Amount decimal Evet Kartın bakiyesinden düşecek ödeme tutarı
BackrefUrl string Evet 3D Secure işleminde üye iş yerine başarılı ya da hatalı sonucu bildiren URL adresi. Bu adrese sonuç JSON olarak dönmektedir.
CardExpireMonth string Evet Ödeme işleminin yapılacağı kartın son kullanma tarihi ayı
CardExpireYear string Evet Ödeme işleminin yapılacağı kartın son kullanma tarihi yılı
CardNumber string Evet Ödeme işleminin yapılacağı kartın üzerinde yazan numara
CardOwner string Evet Ödeme yapılacak kartın üzerinde yazan isim (kartın sahibi)
CardSecurityCode string Evet Ödeme yapılacak kartın arka yüzünde yazan üç haneli güvenlik numarası
ClientIp string Evet Ödemeyi gerçekleştiren üye iş yerine ait IP adresi
Description string Evet Üye iş yerinin ödemeye ait doldurabileceği açıklama alanı
BasketId string Evet Üye iş yerinin ilgili ödemenin sepetini tanımlamak için kullanılan id
Installment string Evet Ödeme işleminin kaç orana bölünerek gerçekleşeceğini belirten taksit miktarı alanı
Language string Evet Bu alana "TR" girilmelidir.
MerchantId string Evet Üye iş yerine ait benzersiz Id numarası
PaymentChannel string Evet Bu alana 'Api' yazılmalıdır
Signature string Evet HMac Sha512 hashleme metodu kullanılarak oluşturulan imza
TransactionId string Evet İstek esnasında gönderilen ve yanıtta döndürülen üye iş yerinin sipariş numarası. 10 ile 60 karakter arasında alfa-numerik olması gerekmektedir.
TransactionTime timestamp Evet İşlemin gerçekleştiği unix timestamp değeri
  

Signature (İmza) Oluşturma

Aşağıdaki alanların art arda eklenmesi ve ardından hashlenmesi ile imza oluşmaktadır. Oluşan imzanın servise gönderilmesi gerekmektedir. Hashlemede kullanılacak algoritma HMac Sha512 algoritmasıdır.

secretKey + MerchantId + TransactionId + TransactionTime + Amount + Currency + Installment + CardNumber (İlk 6 hanesi) 

Servisten Gelen Yanıta Ait Parametreler

Parametre İsmi Tip Açıklama
Message string Girilen bilgiler doğrultusunda servisten dönen mesaj
MessageCode string Dönen mesaja ait kod
Secure3dUrl string Müşterinin ekranında gösterilmesi gereken 3D şifre ekranının oluştuğu Url adresi
Success string Girilen bilgiler doğrultusunda 3D ödeme isteği yapılabiliyorsa true, yapılamıyorsa false döner
SystemTime number Dönen yanıta ait unix timestamp değeri
UserMessage string Dönen yanıta ait kullanıcıya yönelik mesaj
  

JSON Request-Response (İstek-Yanıt)

//Request
                                    {
                                        "MerchantId": "5d891bbeea1e5e94b02b266b",
                                        "Language": "TR",
                                        "TransactionId": "e5180a5a-605b-4f91-b085-6427c595a138",
                                        "BackrefUrl": "http://backref.merchant.com/refpage",
                                        "Currency": "TRY",
                                        "Installment": "3",
                                        "Description": "May the force be with you.",
                                        "BasketId": "123456",
                                        "PaymentChannel": "Api",
                                        "Amount": 12.5,
                                        "CardNumber": "4508034508034509",
                                        "CardExpireMonth": "12",
                                        "CardExpireYear": "30",
                                        "CardSecurityCode": "000",
                                        "CardOwner": "testname",
                                        "ClientIp": "10.10.2.27",
                                        "TransactionTime": "1571819068557",
                                        "Signature": "6e08a470a313634f2f46c4fce375f1c86457fe6c196d0928d32feb0a2376a21db0600e0c268864869f1f975c6d0718301cc2acbeb76f54e89156b112c1199d7a"
                                }
//Response
                                    {
                                        "Secure3dUrl": "https://payinallpostestapi.erpapay.com/api/payment3d/get3dSign/v1?id=e5180a5a-605b-4f91-b085-6427c595a138",
                                        "SystemTime": 1571819080625,
                                        "Success": true,
                                        "MessageCode": "00",
                                        "Message": "Başarılı",
                                        "UserMessage": "3d işlem başlatma başarılı."
                                    }
  

Birinci aşamada servise gönderilen ödeme bilgilerinin ardından servisten bir yanıt döner. Eğer işlem başarılıysa dönen yanıtın içerisinde yer alan Secure3DUrl içerisinde URL adresi saklar. Bu adres ile kullanıcının 3D imza bilgisini girmesi sağlanır. Kullanıcı söz konusu adresi bir tarayıcıda açarak bankadan şifre talep eder ve SMS ile gelen şifreyi girer. Bu aşamadan sonra banka kredi kartı doğrulaması yapar. Bankadan gelen yanıt doğrultusunda kullanıcı işleminin gerçekleşip gerçekleşmediğini tarayıcıda açtığı sayfada görebilir. Ayrıca bankadan dönen yanıt BackrefUrl alanına yazılan adrese JSON şeklinde döner.

Örnek yanıt:

                             {
                                     "TransactionId": "e5180a5a-605b-4f91-b085-6427c595a138",
                                     "SystemTime": "1575969358720",
                                     "Success": true,
                                     "MessageCode": "7280",
                                     "Message": "İşleminiz başarıyla gerçekleştirildi",
                                     "UserMessage": "3D Secure işlemi başarıyla gerçekleştirildi"
                                  }
  

2- 3D Güvenli Ödeme Tamamlama

Servis Adresi:

Test Ortam Adresi:
https://payinallpostestapi.erpapay.com/api/payment3d/complete3dpayment/v1
Gerçek Ortam Adresi:
https://payinallposapi.erpapay.com/api/payment3d/complete3dpayment/v1

Birinci aşamada servise gönderilen ödeme bilgilerinin ardından servisten bir yanıt döner. Eğer işlem başarılıysa dönen yanıtın içerisinde yer alan Secure3DUrl içerisinde URL adresi saklar. Bu adres ile kullanıcının 3D imza bilgisini girmesi sağlanır. Kullanıcı söz konusu adresi bir tarayıcıda açarak bankadan şifre talep eder ve SMS ile gelen şifreyi girer. Bu aşamadan sonra banka kredi kartı doğrulaması yapar. Bankadan gelen yanıt doğrultusunda kullanıcı işleminin gerçekleşip gerçekleşmediğini tarayıcıda açtığı sayfada görebilir. Ayrıca bankadan dönen yanıt BackrefUrl alanına yazılan adrese JSON şeklinde döner.

Kullanıcının Secure2DUrl adresini tarayıcıda açması ve başarılı bir şekilde 3D imza adımını geçmesinin ardından 3D güvenli ödeme tamamlama adımına geçilir. Bu adımda gerekli parametreler verilmesi ile 3D güvenli ödeme işlemi sonuca ulaşır.

Servisten Gönderilmesi Gereken Parametreler

Parametre İsmi Tip Zorunluluk Açıklama
MerchantId string Evet Üye iş yerine ait benzersiz Id numarası
TransactionId string Evet İstek esnasında gönderilen ve yanıtta döndürülen üye iş yerinin sipariş numarası
smsCode string Evet Bu alana "000000" girilmelidir. Bu alan sadece "TEST" ortamı için gereklidir "PROD" ortamda gönderilmemesi gerekir
  

Servise Gelen Yanıta Ait Parametreler

Parametre İsmi Tip Açıklama
Message string Girilen bilgiler doğrultusunda servisten dönen mesaj
MessageCode string Dönen mesaja ait kod
Success string Girilen bilgiler doğrultusunda 3D ödeme isteği yapılabiliyorsa true, yapılamıyorsa false döner
SystemTime timestamp Dönen yanıta ait unix timestamp değeri
UserMessage string Dönen yanıta ait kullanıcıya yönelik mesaj
  

JSON Request-Response (İstek-Yanıt)

//Request
                                   {
                                        "MerchantId": "5d891bbeea1e5e94b02b266b",
                                        "TransactionId": "e5180a5a-605b-4f91-b085-6427c595a138",
                                   }
//Response
                                    {
                                        "SystemTime": 1571819080625,
                                        "Success": true,
                                        "MessageCode": "7280",
                                        "Message": "İşleminiz başarıyla gerçekleştirildi",
                                        "UserMessage": "İşleminiz başarıyla gerçekleştirildi."
                                    }
  

Alt Firma Sorgulama Servisi

Dış hizmet sağlayıcısı firma kendisine ait olan alt firmaların bilgilerini sorgulamak için kullanır.

Servis Adresi:

Test Ortam Adresi:
https://payinallpostestapi.erpapay.com/api/payorder/listMerchantInfo
Gerçek Ortam Adresi:
https://payinallposapi.erpapay.com/api/payorder/listMerchantInfo

Servise Gönderilmesi Gereken Parametreler:

Parametre İsmi Tip Zorunluluk Açıklama
entegratorMerchantId string Evet Dış Hizmet Sağlayıcı için Oluşan MerchantId Bilgisidir
secretKey string Evet Dış Hizmet Sağlayıcısına verilen benzersiz müşteri anahtarı
subMerchantId string Evet Sorgulanmak istenen alt firmaya ait MerchantId bilgisidir
  
Parametre İsmi Tip Açıklama
data string Alt firmanın kayıt bilgileri, çalışma şekli hakkında bilgi döneer
success boolen Girilen bilgiler doğrultusunda dönen boolen cevap
  

JSON Request-Response (İstek-Yanıt)

Request
{
  "entegratorMerchantId": "SbbmGmFaENLRYr7RMDyQK7wl0",
  "secretKey": "YCCWihlQu0mlydmEUrr5OOrZ",
  "subMerchantId": "68d18d8b57c0c13bffe9c281"
}
Response
{
  "success": true,
  "data": {
    "firstname": "ALİ",
    "lastname": "BIÇAK",
    "companyName": "ALİ BIÇAK",
    "taxNo": "3600005166",
    "taxOffice": "Yüreğir Vergi Dairesi Müdürlüğü",
    "bkmId": null,
    "address": "çiçek mah. lale apt. no:5",
    "postCode": "06530",
    "city": "Ankara",
    "distinc": "AKYURT",
    "mcc": "4812",
    "phone": "050 *** ** **",
    "webUrl": "erpapay.com",
    "nace": "01.11.14 - Yağlı tohum yetiştiriciliği (soya fasulyesi, yer fıstığı, pamuk çekirdeği (Hint yağı çekirdeği), keten tohumu, hardal tohumu, nijer tohumu, kolza, aspir tohumu, susam tohumu, ayçiçeği tohumu vb.)",
    "acceptedStatus": "Onaylanmamış İş Yeri",
    "dateCreate": "2025-09-22T17:55:23.670Z",
    "physicalPosId": "",
    "restrictions": {
      "amountRestriction": { "active": false, "maxLimit": 100000, "minLimit": 0 },
      "dailyVolumeRestriction": { "active": false, "limit": 100000 },
      "monthlyVolumeRestriction": { "active": false, "limit": 1000000 },
      "hourRestriction": { "active": false, "startHour": 8, "endHour": 22 },
      "cardOperationRestriction": { "active": false, "limit": 30 },
      "gatewayOperationRestriction": {
        "isBlockedGateways": true,
        "notGatewayIds": ["Ziraat Bankası", "VakıfBank"]
      }
    },
    "paymentGroupInfo": {
      "groupName": "DENEME",
      "blockedDay": 1,
      "isPhysicalGateway": true,
      "debitOnusMerchantPhysicalPosRate": "1",
      "debitNotOnusMerchantPhysicalPosRate": "2.30",
      "creditCardOnusBankMerchantPhysicalPosRate": "1",
      "creditCardNotOnusMerchantPhysicalPosRate": "2.30",
      "debitOnusMerchantVirtualPosRate": "6",
      "debitNotOnusMerchantVirtualPosRate": "6",
      "creditCardOnusBankMerchantVirtualPosRate": "6.5",
      "creditCardNotOnusBankMerchantVirtualPosRate": "6.4",
      "VirtualPosGatewayId": "Halkbank",
      "physicalPosGatewayId": "Halkbank"
    },
    "cardRates": {
      "virtualCardRates": [
        { "installment": 1, "rate": "1.09", "bank": "Ziraat Bankası" },
        { "installment": 2, "rate": "1.93", "bank": "Ziraat Bankası" },
        { "installment": 3, "rate": "2.60", "bank": "Ziraat Bankası" },
        { "installment": 4, "rate": "3.06", "bank": "Ziraat Bankası" },
        { "installment": 5, "rate": "3.72", "bank": "Ziraat Bankası" },
        { "installment": 6, "rate": "4.38", "bank": "Ziraat Bankası" },
        { "installment": 7, "rate": "4.79", "bank": "Ziraat Bankası" },
        { "installment": 8, "rate": "5.45", "bank": "Ziraat Bankası" },
        { "installment": 9, "rate": "6.12", "bank": "Ziraat Bankası" }
      ],
      "physicalCardRates": [
        { "installment": 1, "rate": "1.1", "bank": "Halkbank" },
        { "installment": 2, "rate": "1.4", "bank": "Halkbank" },
        { "installment": 4, "rate": "2.97", "bank": "Halkbank" },
        { "installment": 5, "rate": "3.56", "bank": "Halkbank" },
        { "installment": 6, "rate": "4.15", "bank": "Halkbank" },
        { "installment": 7, "rate": "4.75", "bank": "Halkbank" },
        { "installment": 8, "rate": "5.34", "bank": "Halkbank" },
        { "installment": 9, "rate": "5.93", "bank": "Halkbank" },
        { "installment": 10, "rate": "6.53", "bank": "Halkbank" },
        { "installment": 11, "rate": "7.12", "bank": "Halkbank" },
        { "installment": 12, "rate": "7.71", "bank": "Halkbank" },
        { "installment": 13, "rate": "8.31", "bank": "Halkbank" },
        { "installment": 14, "rate": "8.9", "bank": "Halkbank" },
        { "installment": 15, "rate": "9.49", "bank": "Halkbank" },
        { "installment": 16, "rate": "10.09", "bank": "Halkbank" },
        { "installment": 17, "rate": "10.68", "bank": "Halkbank" },
        { "installment": 18, "rate": "11.27", "bank": "Halkbank" }
      ]
    }
  }
}
  

Alt Firmaya Ait İşlemleri Sorgulama Servisi

Dış hizmet sağlayıcısı firma kendisine ait olan alt firmanın hem sanal hem de fiziki pos da yaptığı işlemleri sorgulayabilir.

Servis Adresi:

Test Ortam Adresi:
https://payinallpostestapi.erpapay.com/api/payorder/listMerchantPayorder
Gerçek Ortam Adresi:
https://payinallposapi.erpapay.com/api/payorder/listMerchantPayorder

Servise Gönderilmesi Gereken Parametreler:

Parametre İsmi Tip Zorunluluk Açıklama
entegratorMerchantId string Evet Dış Hizmet Sağlayıcı için Oluşan MerchantId Bilgisidir
secretKey string Evet Dış Hizmet Sağlayıcısına verilen benzersiz müşteri anahtarı
subMerchantId string Evet Sorgulanmak istenen alt firmaya ait MerchantId bilgisidir
startDate string Evet Sorgulanmak istenen tarihin başlangıç bilgisi
endDate string Evet Sorgulanmak istenen tarihin bitiş bilgisi
  
Parametre İsmi Tip Açıklama
submerchantId string Sorgulanmak istenen alt firmaya ait merchantId bilgisi
virtualPos string Sanal pos işlemlerine ait bilgi
physicalPos string Fiziksel pos işlemlerine ait bilgi
  

JSON Request-Response (İstek-Yanıt)

Request
{
  "entegratorMerchantId": "SbbmGmFaENLRYr7RMDyQK7wl0",
  "secretKey": "YCCWihlQu0mlydmEUrr5OOrZ",
  "subMerchantId": "68d18d8b57c0c13bffe9c281",
  "startDate": "2025-09-01",
  "endDate": "2025-09-02"
}
Response
{
  "submerchantId": "68666fa628f8a97b928d455f",
    "virtualPos": {
        "list": [
            {
                "_id": "68d53ea8c5a6a3f0fde80c88",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "4FQYJJblrb0HxrT",
                "Installment": "1",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 100,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-25T13:07:52.749Z",
                "Status": "Başarısız",
                "OrderId": "gkslXG6RofOonVxuuTsj",
                "merchantRate": 6,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d53e52dba227370c137c0b",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "NvJzSARyXUDmGK6",
                "Installment": "1",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 100,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-25T13:06:26.832Z",
                "Status": "Başarısız",
                "OrderId": "KCS8WzDSxcH3n27465GS",
                "merchantRate": 6,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d52c7edd60db91b3783949",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "O9EcX9r5GDj8j5G",
                "Installment": "1",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 100,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-25T11:50:22.348Z",
                "Status": "Başarısız",
                "OrderId": "TK2lwLYQeXBUxyxHkqY5",
                "merchantRate": 6,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d529948afe2489cafd1757",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "5qKiHJHpu0unXvM",
                "Installment": "1",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 100,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-25T11:37:56.859Z",
                "Status": "Başarısız",
                "OrderId": "u6jKQWJZUpvJpYux9xOk",
                "merchantRate": 4,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d3fe2c5548dfacb70312f8",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "7vlTHrzVwijdyiK",
                "Installment": "0",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 200,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-24T14:20:28.370Z",
                "Status": "Başarısız",
                "OrderId": "bTj5CAl5SepkEn1K8S4u",
                "merchantRate": 4,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d3fe02a81840eb1f8d2869",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "FxBh1BBKC2BtlMV",
                "Installment": "0",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 200,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-24T14:19:46.508Z",
                "Status": "Başarısız",
                "OrderId": "e9P5tZkbp6l0QODX2Wm7",
                "merchantRate": 4,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d3fdb5a81840eb1f8d2834",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "4Me61K21E7jgzba",
                "Installment": "0",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 1,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-24T14:18:29.957Z",
                "Status": "Başarısız",
                "OrderId": "bmtXVQh0x7fjUoLtHnQ6",
                "merchantRate": 4,
                "bankRate": 0.88,
                "bank": "İş Bankası",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d55bc4f8bc5745a3e23d62",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "iUKF0mq1kQJeg4k",
                "Installment": "1",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 100,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-25T15:12:10.040Z",
                "Status": "Başarısız",
                "OrderId": "e2Yj0JBqyT960OFUCjKH",
                "merchantRate": 6,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d55b73069b32c68e022b64",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "pN56B4wNjlCyfF7",
                "Installment": "1",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 100,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-25T15:10:51.188Z",
                "Status": "Başarısız",
                "OrderId": "BmOeJxRbQVzyCCkWDeEG",
                "merchantRate": 6,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d52d44dd60db91b37839ac",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "97g5TXbQv72nbcf",
                "Installment": "1",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 100,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-25T11:54:41.662Z",
                "Status": "Başarısız",
                "OrderId": "8mgcvxRdbagABBgAZlXt",
                "merchantRate": 6,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d52c3d8afe2489cafd17a6",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "A4v7yBn6NHylEbq",
                "Installment": "1",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 100,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-25T11:49:24.222Z",
                "Status": "Başarısız",
                "OrderId": "GB9cTKb3Jq9OjogdR4D4",
                "merchantRate": 6,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d5244b0a3d56dae66d2653",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "cg3BfN0nxX1n8fm",
                "Installment": "0",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 100,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-25T11:15:28.460Z",
                "Status": "Başarısız",
                "OrderId": "Ebv0p0xKiA9eSeWENrwG",
                "merchantRate": 4,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d3fe53a6b7094e9586b861",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "5ws8PUWD31boNTX",
                "Installment": "0",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 200,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-24T14:21:12.725Z",
                "Status": "Başarısız",
                "OrderId": "hwPJeg3rjySf6ReltkZk",
                "merchantRate": 4,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68dfc09cc326411f4c4744bc",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "RPm6uDNa8ux9",
                "OrderId": "d6ww3NvuoyHfb4m2Hny3",
                "Installment": "2",
                "Description": "TestRPm6uDNa8ux9",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "Amount": 8509,
                "CreditCard": {
                    "CardNumber": "162120******1010",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "J***b***",
                    "Bank": "AKBANK T.A.Ş.",
                    "BankCode": 46,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "VISA"
                },
                "DateUpdate": "2025-09-26T12:25:00.019Z",
                "merchantRate": 1.6,
                "bankRate": 1.13,
                "bank": "Yapı Kredi",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68dfc096c326411f4c474460",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "IClxPDwDFoQ7",
                "OrderId": "PUKOuPFmCDB0XX5te3bs",
                "Installment": "10",
                "Description": "TestIClxPDwDFoQ7",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "Amount": 8137,
                "CreditCard": {
                    "CardNumber": "202210******0313",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "t***D***",
                    "Bank": "AKBANK T.A.Ş.",
                    "BankCode": 46,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "VISA"
                },
                "DateUpdate": "2025-09-26T12:24:54.922Z",
                "merchantRate": 1.6,
                "bankRate": 1.13,
                "bank": "Kuveyt Turk",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68de206720e303dec1040aa7",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "9kOF4LuHFyPa",
                "OrderId": "WCWQbrDyTyWO0YN4rekt",
                "Installment": "8",
                "Description": "Test9kOF4LuHFyPa",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "Amount": 1504,
                "CreditCard": {
                    "CardNumber": "561122******5311",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "I***I***",
                    "Bank": "AKBANK T.A.Ş.",
                    "BankCode": 46,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "VISA"
                },
                "DateUpdate": "2025-09-26T06:49:11.267Z",
                "merchantRate": 1.6,
                "bankRate": 1.13,
                "bank": "Şekerbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68de206520e303dec1040a89",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "JEK1wxnqUoJV",
                "OrderId": "06JCN5BdMLicnmbyawEc",
                "Installment": "6",
                "Description": "TestJEK1wxnqUoJV",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "Amount": 3532,
                "CreditCard": {
                    "CardNumber": "280020******6300",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "b***n***",
                    "Bank": "AKBANK T.A.Ş.",
                    "BankCode": 46,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "VISA"
                },
                "DateUpdate": "2025-09-26T06:49:09.621Z",
                "merchantRate": 1.6,
                "bankRate": 1.13,
                "bank": "Yapı Kredi",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68dfc09ec326411f4c4744e6",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "388Q6qzZjcME",
                "OrderId": "VuxPDtwosnzk1ton1L8i",
                "Installment": "3",
                "Description": "Test388Q6qzZjcME",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "Amount": 8353,
                "CreditCard": {
                    "CardNumber": "390040******2100",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "j***I***",
                    "Bank": "AKBANK T.A.Ş.",
                    "BankCode": 46,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "VISA"
                },
                "DateUpdate": "2025-09-25T12:25:02.338Z",
                "merchantRate": 1.6,
                "bankRate": 1.13,
                "bank": "Odeabank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68dfc09cc326411f4c4744c4",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "OkLCoVSidxJl",
                "OrderId": "x1jfpC88ApTDGZa8reru",
                "Installment": "1",
                "Description": "TestOkLCoVSidxJl",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "Amount": 4098,
                "CreditCard": {
                    "CardNumber": "322001******3401",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "C***h***",
                    "Bank": "AKBANK T.A.Ş.",
                    "BankCode": 46,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "VISA"
                },
                "DateUpdate": "2025-09-25T12:25:00.460Z",
                "merchantRate": 1.6,
                "bankRate": 1.13,
                "bank": "Odeabank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68dfc096c326411f4c474452",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "PVYsbxPS55YF",
                "OrderId": "BrQoB5EM3VskkeHgjPGJ",
                "Installment": "11",
                "Description": "TestPVYsbxPS55YF",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "Amount": 6816,
                "CreditCard": {
                    "CardNumber": "160343******5401",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "t***Z***",
                    "Bank": "AKBANK T.A.Ş.",
                    "BankCode": 46,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "VISA"
                },
                "DateUpdate": "2025-09-25T12:24:54.107Z",
                "merchantRate": 1.6,
                "bankRate": 1.13,
                "bank": "Kuveyt Turk",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68de206720e303dec1040aab",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "rnrhUURRdwpl",
                "OrderId": "Lni0WNjz7eGII5Q6nlkh",
                "Installment": "11",
                "Description": "TestrnrhUURRdwpl",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "Amount": 5395,
                "CreditCard": {
                    "CardNumber": "480313******5013",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "n***E***",
                    "Bank": "AKBANK T.A.Ş.",
                    "BankCode": 46,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "VISA"
                },
                "DateUpdate": "2025-09-25T06:49:11.484Z",
                "merchantRate": 1.6,
                "bankRate": 1.13,
                "bank": "Kuveyt Turk",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68dfc099c326411f4c474498",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "2xgkv61TyjM3",
                "OrderId": "AwnS83iFyqudiZVVK1QP",
                "Installment": "7",
                "Description": "Test2xgkv61TyjM3",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "Amount": 769,
                "CreditCard": {
                    "CardNumber": "302233******5303",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "i***F***",
                    "Bank": "AKBANK T.A.Ş.",
                    "BankCode": 46,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "VISA"
                },
                "DateUpdate": "2025-09-24T12:24:57.995Z",
                "merchantRate": 1.6,
                "bankRate": 1.13,
                "bank": "Çekim Yok",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68dfc08bc326411f4c474396",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "cySzNwpKUGYD",
                "OrderId": "p6jhYnl6X8HOvttDIMpl",
                "Installment": "11",
                "Description": "TestcySzNwpKUGYD",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "Amount": 4311,
                "CreditCard": {
                    "CardNumber": "381301******1211",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "H***n***",
                    "Bank": "AKBANK T.A.Ş.",
                    "BankCode": 46,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "VISA"
                },
                "DateUpdate": "2025-09-24T12:24:43.775Z",
                "merchantRate": 1.6,
                "bankRate": 1.13,
                "bank": "Yapı Kredi",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d3b693738be577b2a5398c",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "bJJy2Ms2vXrA",
                "OrderId": "EZL2BN1hyVmmvZ3BZsC0",
                "Installment": "4",
                "Description": "TestbJJy2Ms2vXrA",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "Amount": 7482,
                "CreditCard": {
                    "CardNumber": "281112******1411",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "m***R***",
                    "Bank": "AKBANK T.A.Ş.",
                    "BankCode": 46,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "VISA"
                },
                "DateUpdate": "2025-09-24T09:14:59.944Z",
                "merchantRate": 1.6,
                "bankRate": 1.13,
                "bank": "Şekerbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68dfc09bc326411f4c4744b8",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "pyeUVeXr7DlD",
                "OrderId": "S4vX92diQKE4Iq3Qc6om",
                "Installment": "10",
                "Description": "TestpyeUVeXr7DlD",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "Amount": 4576,
                "CreditCard": {
                    "CardNumber": "100121******6200",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "b***G***",
                    "Bank": "AKBANK T.A.Ş.",
                    "BankCode": 46,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "VISA"
                },
                "DateUpdate": "2025-09-23T12:24:59.777Z",
                "merchantRate": 1.6,
                "bankRate": 1.13,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68dfc095c326411f4c474440",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "lUrOsGM8Axje",
                "OrderId": "Et02nXaolybD7at55v73",
                "Installment": "11",
                "Description": "TestlUrOsGM8Axje",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "Amount": 6780,
                "CreditCard": {
                    "CardNumber": "510043******6110",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "l***E***",
                    "Bank": "AKBANK T.A.Ş.",
                    "BankCode": 46,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "VISA"
                },
                "DateUpdate": "2025-09-23T12:24:53.131Z",
                "merchantRate": 1.6,
                "bankRate": 1.13,
                "bank": "Albaraka",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68de205d20e303dec10409f1",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "SAVT94YsND67",
                "OrderId": "1EU9HnglHYifaOqpkg7B",
                "Installment": "2",
                "Description": "TestSAVT94YsND67",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "Amount": 4969,
                "CreditCard": {
                    "CardNumber": "191350******1010",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "v***s***",
                    "Bank": "AKBANK T.A.Ş.",
                    "BankCode": 46,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "VISA"
                },
                "DateUpdate": "2025-09-23T06:49:01.096Z",
                "merchantRate": 1.6,
                "bankRate": 1.13,
                "bank": "Ziraat Bankası",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d53e38dba227370c137b8c",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "HSQVYMGzql2NmB8",
                "Installment": "2",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 100,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-25T13:06:12.243Z",
                "Status": "Başarısız",
                "OrderId": "iqG6KyV3Xny1dUg6t4lE",
                "merchantRate": 2,
                "bankRate": 2,
                "bank": "Türk Ekonomi Bankası",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d533e6dd60db91b3783a8f",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "821gH6WO5VRXTSF",
                "Installment": "2",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 100,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-25T12:22:04.368Z",
                "Status": "Başarısız",
                "OrderId": "vTUbfwfyT8FcFEQvG5MO",
                "merchantRate": 2,
                "bankRate": 2,
                "bank": "Türk Ekonomi Bankası",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d533b0dd60db91b3783a10",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "vVgJE1oG42l3vmi",
                "Installment": "2",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 100,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-25T12:21:11.358Z",
                "Status": "Başarısız",
                "OrderId": "SPAZMGNOKtzoYlraGjH2",
                "merchantRate": 2,
                "bankRate": 2,
                "bank": "Türk Ekonomi Bankası",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d5295f8afe2489cafd16e0",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "Dt3ftAC4ms1iJaU",
                "Installment": "2",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 100,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-25T11:37:39.122Z",
                "Status": "Başarısız",
                "OrderId": "ROtABA6ANY9nbE82gxuE",
                "merchantRate": 2,
                "bankRate": 2,
                "bank": "Türk Ekonomi Bankası",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68d524740a3d56dae66d26b7",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "dvo7I8q4LI4ueQ4",
                "Installment": "2",
                "Description": "Erpa Api Test Çekimi...",
                "TransactionType": "Satış",
                "Amount": 100,
                "CreditCard": {
                    "CardNumber": "554960******5508",
                    "ExpireMonth": "**",
                    "ExpireYear": "**",
                    "SecurityCode": "***",
                    "CardOwner": "e*** d***",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Brand": "MASTERCARD",
                    "Family": "bonus"
                },
                "DateUpdate": "2025-09-25T11:16:11.641Z",
                "Status": "Başarısız",
                "OrderId": "aliKGxoRVbmjvLW3rwKQ",
                "merchantRate": 2,
                "bankRate": 2,
                "bank": "Türk Ekonomi Bankası",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            }
        ],
        "stats": {
            "totalCount": 32,
            "totalSuccessCount": 14,
            "totalFailCount": 18,
            "totalSaleAmount": 75231,
            "totalCancelAmount": 0,
            "totalRefundAmount": 0
        }
    },
    "physicalPos": {
        "list": [
            {
                "_id": "68e39d893249d0a51939a162",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "176980300",
                "Installment": "1",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "DateUpdate": "2025-09-23T12:03:19.340Z",
                "Amount": 0.1,
                "serialNumber": "N860W6A2433",
                "CreditCard": {
                    "CardNumber": "54070929****7019",
                    "CardOwner": "-",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Family": "bonus",
                    "Brand": "MasterCard"
                },
                "merchantRate": 2.3,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68e39d893249d0a51939a1a8",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "176981477",
                "Installment": "1",
                "TransactionType": "İptal",
                "Status": "Başarılı",
                "DateUpdate": "2025-09-23T12:04:28.767Z",
                "Amount": -0.1,
                "serialNumber": "N860W6A2433",
                "CreditCard": {
                    "CardNumber": "54070929****7019",
                    "CardOwner": "-",
                    "Bank": "T. GARANTİ BANKASI A.Ş.",
                    "BankCode": 62,
                    "Type": "credit",
                    "Family": "bonus",
                    "Brand": "MasterCard"
                },
                "merchantRate": -2.3,
                "bankRate": -1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68e39d893249d0a51939a1ee",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "178242651",
                "Installment": "1",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "DateUpdate": "2025-09-25T10:42:00.047Z",
                "Amount": 100,
                "serialNumber": "N860W6A2433",
                "CreditCard": {
                    "CardNumber": "45431892****3931",
                    "CardOwner": "-",
                    "Bank": "T. İŞ BANKASI A.Ş.",
                    "BankCode": 64,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "Visa"
                },
                "merchantRate": 2.3,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68e39d893249d0a51939a234",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "178476973",
                "Installment": "1",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "DateUpdate": "2025-09-25T14:32:18.170Z",
                "Amount": 43000,
                "serialNumber": "N860W6A2433",
                "CreditCard": {
                    "CardNumber": "51932405****7845",
                    "CardOwner": "V*** K***",
                    "Bank": "FİNANS BANK A.Ş.",
                    "BankCode": 111,
                    "Type": "credit",
                    "Family": "cardfinans",
                    "Brand": "MasterCard"
                },
                "merchantRate": 2.3,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68e39d8a3249d0a51939a27a",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "178478033",
                "Installment": "1",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "DateUpdate": "2025-09-25T14:33:18.647Z",
                "Amount": 60000,
                "serialNumber": "N860W6A2433",
                "CreditCard": {
                    "CardNumber": "97926700****3836",
                    "CardOwner": "K*** T***",
                    "Bank": "KUVEYT TÜRK KATILIM BANKASI A.Ş.",
                    "BankCode": 205,
                    "Type": "credit",
                    "Family": "sağlam",
                    "Brand": "Troy"
                },
                "merchantRate": 2.3,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68e39d8a3249d0a51939a4e4",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "178492582",
                "Installment": "1",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "DateUpdate": "2025-09-25T14:47:02.323Z",
                "Amount": 330000,
                "serialNumber": "N860W6A2433",
                "CreditCard": {
                    "CardNumber": "54006170****6137",
                    "CardOwner": "M*** H***",
                    "Bank": "YAPI VE KREDİ BANKASI A.Ş.",
                    "BankCode": 67,
                    "Type": "credit",
                    "Family": "world",
                    "Brand": "MasterCard"
                },
                "merchantRate": 2.3,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68e39d8a3249d0a51939a52a",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "178508769",
                "Installment": "1",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "DateUpdate": "2025-09-25T15:02:46.913Z",
                "Amount": 50000,
                "serialNumber": "N860W6A2433",
                "CreditCard": {
                    "CardNumber": "51166000****5052",
                    "CardOwner": "K*** T***",
                    "Bank": "KUVEYT TÜRK KATILIM BANKASI A.Ş.",
                    "BankCode": 205,
                    "Type": "credit",
                    "Family": "sağlam",
                    "Brand": "MasterCard"
                },
                "merchantRate": 2.3,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68e39d8a3249d0a51939a570",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "178759027",
                "Installment": "1",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "DateUpdate": "2025-09-26T07:05:28.633Z",
                "Amount": 258000,
                "serialNumber": "N860W6A2433",
                "CreditCard": {
                    "CardNumber": "47434010****0346",
                    "CardOwner": "D*** D***",
                    "Bank": "T. İŞ BANKASI A.Ş.",
                    "BankCode": 64,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "Visa"
                },
                "merchantRate": 2.3,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68e39d8a3249d0a51939a5b6",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "178764241",
                "Installment": "1",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "DateUpdate": "2025-09-26T07:13:08.070Z",
                "Amount": 40000,
                "serialNumber": "N860W6A2433",
                "CreditCard": {
                    "CardNumber": "47434010****0230",
                    "CardOwner": "S*** D***",
                    "Bank": "T. İŞ BANKASI A.Ş.",
                    "BankCode": 64,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "Visa"
                },
                "merchantRate": 2.3,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            },
            {
                "_id": "68e39d8a3249d0a51939a5fc",
                "MerchantId": "68666fa628f8a97b928d455f",
                "TransactionId": "178772376",
                "Installment": "1",
                "TransactionType": "Satış",
                "Status": "Başarılı",
                "DateUpdate": "2025-09-26T07:25:02.960Z",
                "Amount": 215000,
                "serialNumber": "N860W6A2433",
                "CreditCard": {
                    "CardNumber": "45435910****7259",
                    "CardOwner": "B*** A***",
                    "Bank": "T. İŞ BANKASI A.Ş.",
                    "BankCode": 64,
                    "Type": "credit",
                    "Family": "maximum",
                    "Brand": "Visa"
                },
                "merchantRate": 2.3,
                "bankRate": 1.2,
                "bank": "Halkbank",
                "company": "ERPA ÖDEME HİZMETLERİ A.Ş."
            }
        ],
        "stats": {
            "totalCount": 10,
            "totalSuccessCount": 10,
            "totalFailCount": 0,
            "totalSaleAmount": 996100.1,
            "totalCancelAmount": -0.1,
            "totalRefundAmount": 0
        }
    }
}
  

Ön Provizyonlu Ödeme

Servis Adresi:

Test Ortam Adresi:
https://payinallpostestapi.erpapay.com/api/payment3d/capture/v1
Gerçek Ortam Adresi:
https://payinallposapi.erpapay.com/api/payment3d/capture/v1

Öncelikle ön provizyonlu ödeme yapabilmek için üye işyerinin VakıfBank'a tanımlı olup ön provizyon onayı alınması gerekmektedir. Daha sonra eğer ön provizyonlu ödeme yapılmak istenirse, ödeme bilgilerini gönderme servisinde isAuth parametresi true olarak gönderilir. isAuth Parametresi true olarak gönderildikten sonra yukarıda belirtilen bitirme servisine gerekli parametreler gönderilerek ön provizyonlu ödeme tamamlanmış olur. Ön provizyonlu ödeme şeklinde, para 25 gün askıda kalmakta olup 26.gün işlem iptal olmaktadır.

Servisten Gönderilmesi Gereken Parametreler

Parametre İsmi Tip Zorunluluk Açıklama
MerchantId string Evet Üye iş yerine ait benzersiz Id numarası
SecretKey string Evet Üye iş yerine ait benzersiz Id numarası
TransactionId string Evet İstek esnasında gönderilen ve yanıtta döndürülen üye iş yerinin sipariş numarası. 10 ile 60 karakter arasında alfa-numerik olması gerekmektedir.
  

Servise Gelen Yanıta Ait Parametreler

Parametre İsmi Tip Açıklama
TransactionId string üye iş yerinin sipariş numarası
SystemTime string Dönen yanıta ait unix timestamp değeri
Success string Girilen bilgiler doğrultusunda ön provizyonlu işlem yapıldıysa true, yapılmadıysa false döner
MessageCode timestamp Dönen mesaja ait kod
Message string Girilen bilgiler doğrultusunda servisten dönen mesaj
  

JSON Request-Response (İstek-Yanıt)

//Request
                                   {
                                        "MerchantId": "5fe9e0068ce7bc27e8472ebe",
                                        "SecretKey": "RNBYJYuTn77PruEndjOY3JiP",
                                        "TransactionId": "DOFu0KQyZ6pQ",
                                   }
//Response
                                    {
                                        "TransactionId": DOFu0KQyZ6pQ,
                                        "SystemTime": 1643899034500,
                                        "Success": true,
                                        "MessageCode": "00",
                                        "Message": "VakıfBank Provizyon Kapama Başarılı.",
                                    }
  

Ödeme Sorgulama

Servis Adresi:

Test Ortam Adresi:
https://payinallpostestapi.erpapay.com/api/payment3d/paymentInfo/v1
Gerçek Ortam Adresi:
https://payinallposapi.erpapay.com/api/payment3d/paymentInfo/v1

Taksit sorgulama işlemi bir kredi kartı girildiğinde ve kredi kartı anlaşmalı bir taksit programına dahilse, kartın ilk 6 hanesinin kullanılması ile taksit oranları hakkında bilgi vermektedir.

Ödeme sorgulama işlemi üye iş yeri Id'si ve bir sipariş numarası girildiğinde, söz konusu sipariş numarasına ait ödemenin kayıtlara geçip geçmeme bilgisi ve ödemenin detayları ile ilgili bilgi verir.

Servise Gönderilmesi Gereken Parametreler

Parametre İsmi Tip Zorunluluk Açıklama
MerchantId string Evet Üye iş yerine ait benzersiz Id numarası
TransactionId string Evet İstek esnasında gönderilen ve yanıtta döndürülen üye iş yerinin sipariş numarası
  

Servisten Gelen Yanıta Ait Parametreler

Parametre İsmi Tip Açıklama
TransactionId string İstek esnasında gönderilen ve yanıtta döndürülen üye iş yerinin sipariş numarası
SystemTime timestamp Dönen yanıta ait unix timestamp değeri
Success string Girilen bilgiler doğrultusunda 3D ödeme isteği yapılabiliyorsa true, yapılamıyorsa false döner
Amount decimal Kartın bakiyesinden düşen ödeme tutarı
TotalPay string Üye iş yerine ödenecek toplam tutar
MessageCode string Dönen mesaja ait kod
Message string Girilen bilgiler doğrultusunda servisten dönen mesaj
UserMessage string Dönen yanıta ait kullanıcıya yönelik mesaj
ErrorCode string Dönen hata mesajına ait kod
ErrorDetail string Girilen bilgiler doğrultusunda servisten dönen hata mesajı detayı
  

JSON Request-Response (İstek-Yanıt) (Başarılı/Başarısız İşlem Örneği)

//Request
                                   {
                                        "MerchantId": "5d891bbeea1e5e94b02b266b",
                                        "TransactionId": "test123456789"
                                   }
//Response
                                    {
                                        "TransactionId": "test123456789",
                                        "SystemTime": 1574077298636,
                                        "Success": true,
                                        "Amount": "100.00",
                                        "TotalPay": "98.1500",
                                        "MessageCode": "0000",
                                        "Message": "İşlem Başarılı",
                                        "UserMessage": "İşlem Başarılı"
                                    }
  
//Request
                                   {
                                        "MerchantId": "60eda22e72243031a024bb89",
                                        "TransactionId": "Rf4e0PgwGG4G"
                                   }
//Response
                                    {
                                        "TransactionId": "Rf4e0PgwGG4G",
                                        "SystemTime": 1641116967200,
                                        "Success": false,
                                        "MessageCode": "7719",
                                        "Message": "İşlem Başarısız",
                                        "UserMessage": "İşlem Başarısız"
                                        "ErrorCode": "58",
                                        "ErrorDetail": "POSa İzin Verilmeyen İşlem"
                                    }
  

İPTAL SERVİSİ

Servis Adresi:

Test Ortam Adresi:
https://payinallpostestapi.erpapay.com/api/void/v1/create/void
Gerçek Ortam Adresi:
https://payinallposapi.erpapay.com/api/void/v1/create/void

İptal servisi aynı gün içinde çalışmaktadır, ertesi gün iptal işlemi yapılamaz. İptal servisinde, request bilgisinde TransactionId,secretKey ve MerchantId bilgisi gönderilmektedir. Dönen sonuç başarılı olduğunda işlem direkt olarak iptal edilmiş olmaktadır.

Servise Gönderilmesi Gereken Parametreler

Parametre İsmi Tip Zorunluluk Açıklama
payorderId string Evet İstek esnasında gönderilen ve yanıtta döndürülen üye iş yerinin işlem numarası
secretKey string Evet İstek esnasında gönderilen üye iş yerinin secretkey bilgisi
merchantId string Evet Üye iş yerini belirten benzersiz bir numara
  

Servisten Gelen Yanıta Ait Parametreler

Parametre İsmi Tip Açıklama
TransactionId string üye iş yerinin işlem numarası
MessageCode string Dönen mesaja ait kod
Message string Girilen bilgiler doğrultusunda servisten dönen mesaj
UserMessage string Dönen yanıta ait kullanıcıya yönelik mesaj
ErrorCode string Dönen hata mesajına ait kod
  

JSON Request-Response (İstek-Yanıt) (Başarılı İşlem Örneği)

//Request
                                   {
                                        "payorderId": "test123456789",
                                        "merchantId": "5d891bbeea1e5e94b02b266b",
                                        "secretKey": "Xfur6QewXiKMHXsPJmnRrJkF"

                                        }
//Response
                                    {
                                        "TransactionId": "test123456789",
                                        "SystemTime": 1758713039283,
                                        "Success": true,
                                        "MessageCode": "00",
                                        "Message": "Başarılı",
                                        "UserMessage": "İşleminiz başarıyla gerçekleştirildi.",

                                    }
  

İade SERVİSİ

Servis Adresi:

Test Ortam Adresi:
https://payinallpostestapi.erpapay.com/api/refund/v1/create/refund
Gerçek Ortam Adresi:
https://payinallposapi.erpapay.com/api/refund/v1/create/refund

İade servisi ertesi gün işlemlerde çalışmaktadır, aynı gün içinde iade işlemi yapılmaz. İade servisinde, request bilgisinde TransactionId, secretKey, description, status ve MerchantId gönderilmektedir. İşlem başarılı olduğunda, response kısmında iade edilecek işlemin bilgileri bulunmaktadır ve bu sırada payinall'a istek düşmektedir. İade işlemi payinall tarafından onaylandığında işlem iade edilmiş olmaktadır.

Servise Gönderilmesi Gereken Parametreler

Parametre İsmi Tip Zorunluluk Açıklama
payorderId string Evet İstek esnasında gönderilen ve yanıtta döndürülen üye iş yerinin sipariş numarası
merchantId string Evet Üye iş yerini belirten benzersiz bir numara
secretKey string Evet Üye iş yerini belirten benzersiz bir numara
makerDescription string Evet İade işlemi sırasında gönderilen açıklama bilgisi
status number Evet İade işlemi olduğunu belirten statu bilgisi
  

Servisten Gelen Yanıta Ait Parametreler

Parametre İsmi Tip Açıklama
status String İşlemin başarılı ya da başarısız olma durumunda dönen sonuç
approval string üye iş yerinin iade ettiği işlem bilgisi
Message string Girilen bilgiler doğrultusunda servisten dönen mesaj
  

JSON Request-Response (İstek-Yanıt)

//Request
                                    
                                    {
                                        "payorderId": "test123456789",
                                        "merchantId": "5d891bbeea1e5e94b02b266b",
                                        "secretKey": "Xfur6QewXiKMHXsPJmnRrJkF",
                                        "makerDescription": "iade ödemesi deneme"
                                        "status": 4

                                        }
                                   
//Response
                                    {
                                        "status": "OK",
                                        "approval": 
                                        {
                                        "makerDescription": "deneme",
                                        "type": 4,
                                        "payorderId": "68cbd131bf1566a23cddd6b6",
                                        "merchantId": "687f626b3c88616d096815ef",
                                        "active": true,
                                        "_id": "68d3d7308e71e8f44007b005",
                                        "dateCreate": "2025-09-24T11:34:08.749Z",
                                        "__v": 0
                                        },
                                        "message": "İade Talebiniz Payinall'a Düşmüştür",
                                    }
                                    
  

İade SERVİSİ

Servis Adresi:

Test Ortam Adresi:
https://payinallpostestapi.erpapay.com/api/refund/refundMerchantUser/v1
Gerçek Ortam Adresi:
https://payinallposapi.erpapay.com/api/refund/refundMerchantUser/v1

İade servisi ertesi gün işlemlerde çalışmaktadır, aynı gün içinde iade işlemi yapılmaz. İade servisinde, request bilgisinde TransactionId ve MerchantId gönderilmektedir. İşlem başarılı olduğunda, response kısmında iade edilecek işlemin bilgileri bulunmaktadır ve bu sırada payinall'a istek düşmektedir. İade işlemi payinall tarafından onaylandığında işlem iade edilmiş olmaktadır.

Servise Gönderilmesi Gereken Parametreler

Parametre İsmi Tip Zorunluluk Açıklama
TransactionId string Evet İstek esnasında gönderilen ve yanıtta döndürülen üye iş yerinin sipariş numarası
MerchantId string Evet Üye iş yerini belirten benzersiz bir numara
  

Servisten Gelen Yanıta Ait Parametreler

Parametre İsmi Tip Açıklama
Success boolean İşlemin başarılı ya da başarısız olma durumunda dönen sonuç
TransactionId string üye iş yerinin sipariş numarası
MessageCode string Dönen mesaja ait kod
Message string Girilen bilgiler doğrultusunda servisten dönen mesaj
UserMessage string Dönen yanıta ait kullanıcıya yönelik mesaj
  

JSON Request-Response (İstek-Yanıt)

//Request
                                    
                                    {
                                        "TransactionId": "test123456789"
                                        "MerchantId": "5d891bbeea1e5e94b02b266b"
                                    }
                                   
//Response
                                    {
                                        "status": "1",
                                        "Message": "İşlem zaten bekleme listesinde",
                                    }
                                    
  
//Request
                                    {
                                        "TransactionId": "test123456789"
                                        "MerchantId": "5d891bbeea1e5e94b02b266b"
                                    }
                                   
//Response
                                    {
                                        "status": "OK",
                                        "Message": "İşlem zaten bekleme listesinde",
                                    }
                                    
  

İşlem Listeleme Servisi

Servis Adresi:

Test Ortam Adresi:
https://payinallpostestapi.erpapay.com/api/transaction/PayorderInfo
Gerçek Ortam Adresi:
https://payinallposapi.erpapay.com/api/transaction/PayorderInfo

Yapılan satış, iptal, iade işlemlerinin başarılı ya da başarısız olma durumlarını öğrenmek için kullanılan servistir. Request kısmında token, başlangıç ve bitiş tarihleri MerchantId ve status bilgileri gönderilmektedir.

Servise Gönderilmesi Gereken Parametreler

Parametre İsmi Tip Zorunluluk Açıklama
token string Evet login olma servisinde oluşturulan token bilgisi
merchantID string Evet Üye iş yerini belirten benzersiz bir numara
statustype string Hayır işlemin başarılı ya da başarısız olma durumunu gösteren bilgi. Başarılı işlem için 0 başarısız işlem için 1 gönderilir.
startDate string Evet Filtreleme için gönderilen başlangıç tarihi
endDate string Evet Filtreleme için gönderilen bitiş tarihi
  

Servisten Gelen Yanıta Ait Parametreler

Parametre İsmi Tip Açıklama
data array işlemleri gösterir
totaltransaction number yapılan toplam işlem sayısı
successtransaction number yapılan toplam başarılı işlem sayısı
successrefund number yapılan başarılı iade sayısı
successcancel number yapılan başarılı iptal sayısı
totalrefund number günlük işlem tutarı
netsale number günlük net işlem tutar
footertotal number toplam tutar
footercount number toplam işlem sayısı
  

JSON Request-Response (İstek-Yanıt)

//Request
                                    
                                    {
                                        "endDate": "2022-07-05T23:59:59.999Z"
                                        "startDate": "2022-07-05T00:00:00.000Z"
                                        "token": "2528e2b0c4cf385b3b9e611d24445d848867be2225bf07154fe265b039a6daas"
                                        "statustype": 0
                                        "merchantId": "622b62b5cf936dbdda1b775v"
                                    }
                                   
//Response
                                        {
                                            "data": [
                                            {
                                              "PfTotalRate": 1.6
                                              "GatewayId": "5db0147d2dcad11632c4675b
                                              "OrderId": "PjjmajFk8kF1I1uR4GGH
                                              "Status": 7
                                              "Currency": "TRY"
                                              "Installment": "1"
                                              "PaymentChannel": "payinall"
                                              "Amount": 400
                                              "TotalFee": 1.1
                                              "TotalPay": 1
                                              "DateUpdate": "05-07-2022 10:58:30"

                                            }
                                        ],
                                            "totaltransaction": 3,
                                            "successtransaction": 2,
                                            "successrefund": 1,
                                            "totalsale": 1300,
                                            "totalrefund": 400,
                                            "netsale": 900,
                                            "footercount": 3,
                                            "footertotal": 1700,
                                        }
                                    
  

Logın Servisi

Servis Adresi:

Test Ortam Adresi:
https://payinallpostestapi.erpapay.com/api/oauth/token
Gerçek Ortam Adresi:
https://payinallposapi.erpapay.com/api/oauth/token

Login servisine kullanıcı adı ve şifre gönderilerek sonucunda token oluşmaktadır.

Servise Gönderilmesi Gereken Parametreler

Parametre İsmi Tip Zorunluluk Açıklama
grant_type string Evet Standart olarak "password" gönderilir.
client_id string Evet Standart olarak "wepApi" gönderilir.
client_secret string Evet İstek esnasında gönderilen ve yanıtta döndürülen üye iş yerinin sipariş numarası
username string Evet Kullanıcı adı gönderilmektedir.
password string Evet Şifre gönderilmektedir.
  

Servisten Gelen Yanıta Ait Parametreler

Parametre İsmi Tip Açıklama
access_token string üye iş yerinin token bilgisi
expires_in number oluşan token süresi
sms_authentication boolean sms doğrulamasının olup olmadığını gösterir
count number yanlış istek atma sayısı
lastTryDate string en son yanlış istek atma tarihi
token_type string oluşan token tipi
  

JSON Request-Response (İstek-Yanıt)

//Request
                                   {
                                        "grant_type": "password"
                                        "client_id": "wepApi"
                                        "client_secret": "erparaclientsecret"
                                        "username": ""
                                        "password": ""
                                   }
//Response
                                    {
                                        "access_token": "caacf028cd63e039c561a4f4f4e9f79d9a879fe679607a153c3708129d089b5b",
                                        "expires_in": 3600,
                                        "sms_authentication": true,
                                        "count": 0,
                                        "lastTryDate": " ",
                                        "token_type": "Bearer",
                                    }
  

Test Bilgileri

Üye İşyeri / Müşteri Numarası Üye İşyeri / entegratorMerchantId Alt Üye İşyeri / Müşteri Numarası Secret Key Kart Numarası Tarih CVV 3D Şifre
687f626b3c88616d096815ef cZokwCE4xxmguhbTp17W9rEsU 68ecc24113a9c737d5ba7f13 Xfur6QewXiKMHXsPJmnRrJkF 4876125794792381 12/30 999 000000
 

ÖRNEK KODLAR - Signature Oluşturma

                                        

                                     {
                                         
                                            $time = time(); //unix time 
                                            $secret_key =  "HCxZAa9tCkLP2N6JjgGbKA9R";
                                            $merchant_id =  "606f0f2072f1094060ebb6b6";
                                            $transaction_id =  uniqid();
                                            $transaction_time =  $time; 
                                            $transaction_amount =  350;
                                            $transaction_currency =  "TRY";
                                            $transaction_installment =  "2";
                                            $transaction_CardNumber =  "4691810771946876";
                                            $holded =  $secret_key . $merchant_id . $transaction_id . $transaction_time . strval($transaction_amount) . 
                                            $transaction_currency . $transaction_installment . $transaction_CardNumber;
                                            $secretRESULTkey =  bin2hex(hash_hmac('SHA512', $holded, $secret_key, true));

                                     }

                                        
						    


                                    const crypto = require('crypto'); //npm install crypto --save
                                    let secretKey = "HCxZAa9tCkLP2N6JjgGbKA9R";
                                    let merchantId = "606f0f2072f1094060ebb6b6";
                                    let transaction = 
                                    {
                                                    Amount: "100",
                                                    Currency: "TRY",
                                                    Installment: "1",
                                                    MerchantId: merchantId,
                                                    TransactionId: make_transaction_id(15),
                                                    TransactionTime: nowDate.getUnixTime(),
                                                    CardNumber: "4691810771946876"
                                   }
                                   let word = secretKey.toString() + transaction.MerchantId + transaction.TransactionId + transaction.TransactionTime + 
                                   transaction.Amount.toString() + transaction.Currency + transaction.Installment + transaction.CardNumber;
                                   let signature = crypto.createHmac('SHA512', secretKey.toString()).update(word).digest('hex').toString('base64');


							    


                                    /** HashingHelper Sınıfını eklediğinizi varsayarsak */
                                    
                                    public static string CreateParemeterMessage(string secretKey,PaymentRequest paymentRequest)
                                    {       
                                        return secretKey + paymentRequest.MerchantId + paymentRequest.TransactionId +paymentRequest.TransactionTime+ 
                                            paymentRequest.Amount
                                            + paymentRequest.Currency + paymentRequest.Installment + paymentRequest.CardNumber;
                                    }
                                    public static string CreateHash512(string secretKey,string paremeterMessage)
                                    {
                                        var stringBuilder = new StringBuilder(); ;
                                        byte[] secretkeyBytes = Encoding.UTF8.GetBytes(secretKey);
                                        byte[] paremeterBytes = Encoding.UTF8.GetBytes(paremeterMessage);
                                        using (var hmac512 = new HMACSHA512(secretkeyBytes))
                                        {
                                            byte[] hashValue = hmac512.ComputeHash(paremeterBytes);
                                            foreach (var value in hashValue)
                                            {
                                                stringBuilder.Append(value.ToString("x2"));
                                            }
                                        }
                                        return stringBuilder.ToString();
                            
                                     }

                                    const string SecretKey = "HCxZAa9tCkLP2N6JjgGbKA9R";
                                    const string MerchantId = "606f0f2072f1094060ebb6b6";
                                  
                                    var paremeterMessage = HashingHelper.CreateParemeterMessage(SecretKey, paymentRequest);
                                    paymentRequest.Signature = HashingHelper.CreateHash512(SecretKey, paremeterMessage);


							    



                                    let secret_key = "HCxZAa9tCkLP2N6JjgGbKA9R";
                                    let merchant_id = "606f0f2072f1094060ebb6b6";
                                    let transaction_id = make_transaction_id(15);
                                    let transaction_time = Math.round(new Date().getTime() / 1000);
                                    let transaction_amount = "100";
                                    let transaction_currency = "TRY";
                                    let transaction_installment = "1";
                                    let transaction_CardNumber = "4691810771946876";
                                    let word2 = secret_key.toString() + merchant_id + transaction_id + transaction_time + 
                                    transaction_amount.toString() + transaction_currency + transaction_installment + transaction_CardNumber;
                                    let hash = sha512.hmac.create(secret_key.toString());
                                    hash.update(word2);
                                    
      

								

İLETİŞİM

Talep ve görüşleriniz için bizimle iletişime geçebilirsiniz.


Mustafa Kemal Mah. 2125. Sok. No: 5 Payinall Plaza, Çankaya Ankara

0312 439 04 39