SANAL POS ENTEGRASYON DOKÜMANI Versiyon 1.8 03 Temmuz 2014
Versiyon Tarih Açıklama 1.1 19 Eylül 2012 RRN İle İade 1.2 05 Şubat 2013 İndirim Entegrasyon 1.3 27 Şubat 2013 Avea Entegrasyonu 1.4 02 Ağustos 2013 Betek Entegrasyonu 1.5 10 Eylül 2013 SGK Komisyon Entegrasyonu 1.6 26 Eylül 2013 Ön Ödemeli Kart Entegrasyonu 1.7 26 Kasım 2013 Alt Bayi Kodu Entegrasyonu 1.8 07 Mayıs 2014 AVS Desteği 1.9 24 Eylül 2014 Dosya Kayıtları Durum Sorgulama
Contents Entegrasyon Dokümanı İçeriği ve Kimler için Hazırlandığı... 4 AVS Desteği... 4 İş Bankası Bölüm Kodu Kullanımı... 4 Bölüm Kodu Sisteme Tanımlanmamışsa... 4 Bölüm Kodu Sisteme 1 Tanımlanmışsa... 7 Bölüm Kodu Boş Gönderildiğinde... 7 Bölüm Kodu 2 Gönderildiğinde... 9 Bölüm Kodu Sisteme 1 ve 2 Tanımlanmışsa... 11 Bölüm Kodu 1 Gönderildiğinde... 11 Bölüm Kodu 2 Gönderildiğinde... 14 Bölüm Kodu 3 Gönderildiğinde... 16 Dönen Değerlerin Raporlar Ekranındaki Görünümü... 18 Maximum Fırsat Api Entegrasyonu... 19 Maxi Puan Sorgulama Api Entegrasyonu... 19 Maxi Puan Sorgulama İsteği:... 19 Maxi Puan Sorgulama Yanıtı:... 19 Maxi Puan Kullanma Api Entegrasyonu... 20 Maxi Puan Kullanma İsteği:... 20 Maxi Puan Kullanma Yanıtı:... 20 RRN ile İade Api Entegrasyonu... 21 RRN ile İade İsteği:... 21 RRN ile İade Yanıtı:... 22 İndirimli İşlemEntegrasyonu... 22 İndirimli İşlem Api Entegrasyonu:... 22 Satış Isteği... 22 İndirimli İşlem Rapor Ekranı Entegrasyonu :... 23 TCKN ile Kontür Yükleme Entegrasyonu... 25 Betek Entegrasyonu... 26 SGK Ödemeleri, Komisyonlu Ödeme Entegrasyonu... 27 Ön Ödemeli Kart Entegrasyonu... 28 Bakiye Yükleme Mesaj Formatı... 28 Bakiye Yükleme Satış Mesaj Formatı... 30 Üye İşyeri Rapor Ekranları... 31 Alt Bayi Kodu Entegrasyonu... 33 Dosya Kayıtlarının Durumunun Sorgulanması... 34 JVPOS API Örneği... 34 JPAY API Örneği... 37
Entegrasyon Dokümanı İçeriği ve Kimler için Hazırlandığı Bu doküman, bankaya özel entegrasyon bilgilerini içermektedir. Sana POS kullanan üye iş yerlerinde entegratörlerin bankaya özel entegrasyon bilgilerine kolayca erişebilmesi için oluşturulmuştur. AVS Desteği İş Bankası Londra üye işyerleri için AVS (Address Verification System) kullanımı zorunlu olduğu için, entegre olan üye işyerleri işlem sırasında Fatura adresi bilgilerini göndermek zorundadırlar. API ve Güvenli Ödeme Sayfaları entegrasyon yöntemlerinin hepsi için bu alanlar zorunludur. <BillTo> <Street1>Fatura adresi 1. satır </Street1> <Street2>Fatura adresi 2. satır </Street2> <Street3>Fatura adresi 3. satır </Street3> <StateProv>Faturalanacak ilçe</stateprov> </BillTo> İş Bankası Bölüm Kodu Kullanımı Bölüm kodu bankadan gelen talimata göre Nestpay'de tanımlanır. Bölüm kodu tanımlanmadan veya tanımlandıktan sonraki davranış örnekleri aşağıdaki gibidir. Bölüm Kodu Sisteme Tanımlanmamışsa Bölüm kodu tanımlı değil ise sistem otomatik "1" gönderir ve "99" (CORE-2131) hatası yani "Bolum bilgisi uyumsuzlugu. Request'teki bolum bilgisini kontrol ediniz." hatası döner. Bu senaryoya göre örnek kod aşağıdaki gibidir: <PayRequest> <Ecom_Merchant_User_Password>***</Ecom_Merchant_User_Password> <Ecom_System_User_ID>0</Ecom_System_User_ID> <Ecom_Merchant_ID>700100000000</Ecom_Merchant_ID> <Ecom_ConsumerOrderID> bolumsadecetanimsiz1gonderim </Ecom_ConsumerOrderID> <Ecom_ConsumerCriteria1></Ecom_ConsumerCriteria1>
<Ecom_ConsumerCriteria2></Ecom_ConsumerCriteria2> <Ecom_ConsumerCriteria5>1</Ecom_ConsumerCriteria5> <Ecom_Transaction_Type>Auth</Ecom_Transaction_Type> <Ecom_Payment_Card_Number> 424242:4713AA105D5D9E8B7C857A75348DD5236F1DD5AA262 8398597698F36508A204E:3268:# </Ecom_Payment_Card_Number> <Ecom_Payment_Amount>9.95</Ecom_Payment_Amount> <Ecom_Payment_CurrencyCode>949</Ecom_Payment_CurrencyCode> <Ecom_3D_ECI></Ecom_3D_ECI> <Ecom_3D_CAVV></Ecom_3D_CAVV> <Ecom_3D_XID>gRh8rGGwE4tWPaKxqVoakRWC5x0=</Ecom_3D_XID> <Ecom_APIVersion>JVPosApi v.2.0</ecom_apiversion> <Ecom_Transaction_Comments></Ecom_Transaction_Comments> <Ecom_Consumer_IP_Address> 192.168.0.1 </Ecom_Consumer_IP_Address> <Ecom_Payment_Installments></Ecom_Payment_Installments> <Ecom_BillTo_Postal_Company></Ecom_BillTo_Postal_Company> <Ecom_BillTo_Postal_Name>***</Ecom_BillTo_Postal_Name> <Ecom_BillTo_Postal_Street_Line1></Ecom_BillTo_Postal_Street_Line1> <Ecom_BillTo_Postal_Street_Line2></Ecom_BillTo_Postal_Street_Line2> <Ecom_BillTo_Postal_City></Ecom_BillTo_Postal_City> <Ecom_BillTo_Telecom_Phone_Number></Ecom_BillTo_Telecom_Phone_Number> <Ecom_BillTo_Postal_PostalCode></Ecom_BillTo_Postal_PostalCode> <Ecom_BillTo_Postal_StateProv></Ecom_BillTo_Postal_StateProv> <Ecom_BillTo_Postal_CountryCode></Ecom_BillTo_Postal_CountryCode> <Ecom_BillTo_Online_Email></Ecom_BillTo_Online_Email> <Ecom_ShipTo_Postal_Company></Ecom_ShipTo_Postal_Company> <Ecom_ShipTo_Postal_Name></Ecom_ShipTo_Postal_Name> <Ecom_ShipTo_Postal_Street_Line1></Ecom_ShipTo_Postal_Street_Line1> <Ecom_ShipTo_Postal_Street_Line2></Ecom_ShipTo_Postal_Street_Line2> <Ecom_ShipTo_Postal_City></Ecom_ShipTo_Postal_City> <Ecom_ShipTo_Postal_PostalCode></Ecom_ShipTo_Postal_PostalCode> <Ecom_ShipTo_Postal_StateProv></Ecom_ShipTo_Postal_StateProv> <Ecom_ShipTo_Postal_CountryCode></Ecom_ShipTo_Postal_CountryCode> <Ecom_Order_Items> <Ecom_Order_Item>
<Name>a5</Name> <Description>a4 desc</description> <Total_Amount>7.50</Total_Amount> <Units>3</Units> <No>a1</No> <Code>a2</Code> <Unit_Amount>6.25</Unit_Amount> </Ecom_Order_Item> </Ecom_Order_Items> <Ecom_ExtraFields> <TXSTATUS>N</TXSTATUS> <ORIGIN> Ce3CdgkcCCrrVK9M+TVLrToJVZ3keaFXDiA/1k8euJE= </ORIGIN> </Ecom_ExtraFields> </PayRequest> <PayResponse> <Ecom_Transaction_Date>2011-05-31 11:41:45.067</Ecom_Transaction_Date> <Ecom_Transaction_Reference_ID></Ecom_Transaction_Reference_ID> <Ecom_Transaction_ApprovalCode></Ecom_Transaction_ApprovalCode> <Ecom_Transaction_ErrorCode>CORE-2131</Ecom_Transaction_ErrorCode> <Ecom_Transaction_ErrorText> Bolum bilgisi uyumsuzlugu. Request'teki bolum bilgisini kontrol ediniz. </Ecom_Transaction_ErrorText> <Ecom_Transaction_Trace_Audit></Ecom_Transaction_Trace_Audit> <Ecom_Transaction_ReturnCode>99</Ecom_Transaction_ReturnCode> <Ecom_Transaction_ID>11151-LptA-1-0254</Ecom_Transaction_ID> <Ecom_ConsumerOrderID></Ecom_ConsumerOrderID> <Ecom_Transaction_Settle_ID></Ecom_Transaction_Settle_ID> <Ecom_ExtraFields> <HOSTDATE>1227-083957</HOSTDATE> </Ecom_ExtraFields> </PayResponse>
Bölüm Kodu Sisteme 1 Tanımlanmışsa Bölüm Kodu Boş Gönderildiğinde Bölüm kodu sistemde tanımlanmış, fakat üye iş yeri tarafından boş gönderildiğinde işlem onay alır. <PayRequest> <Ecom_Merchant_User_Password>***</Ecom_Merchant_User_Password> <Ecom_System_User_ID>0</Ecom_System_User_ID> <Ecom_Merchant_ID>700100000000</Ecom_Merchant_ID> <Ecom_ConsumerOrderID> bolumsadece1tanimlibosgonderim </Ecom_ConsumerOrderID> <Ecom_ConsumerCriteria1></Ecom_ConsumerCriteria1> <Ecom_ConsumerCriteria2></Ecom_ConsumerCriteria2> <Ecom_Transaction_Type>Auth</Ecom_Transaction_Type> <Ecom_Payment_Card_Number> 424242:DA7529BDA9274F06EAAC60D7543B95A605EAC4A89A5A6A 4E5A1D93FE37AE2079:3966:# </Ecom_Payment_Card_Number> <Ecom_Payment_Amount>9.95</Ecom_Payment_Amount> <Ecom_Payment_CurrencyCode>949</Ecom_Payment_CurrencyCode> <Ecom_3D_ECI></Ecom_3D_ECI> <Ecom_3D_CAVV></Ecom_3D_CAVV> <Ecom_3D_XID>YghYj6BqZMu8/PuPhZ8PJg825uA=</Ecom_3D_XID> <Ecom_APIVersion>JVPosApi v.2.0</ecom_apiversion> <Ecom_Transaction_Comments></Ecom_Transaction_Comments> <Ecom_Consumer_IP_Address>192.168.0.1</Ecom_Consumer_IP_Address> <Ecom_Payment_Installments></Ecom_Payment_Installments> <Ecom_BillTo_Postal_Company></Ecom_BillTo_Postal_Company> <Ecom_BillTo_Postal_Name>***</Ecom_BillTo_Postal_Name> <Ecom_BillTo_Postal_Street_Line1></Ecom_BillTo_Postal_Street_Line1> <Ecom_BillTo_Postal_Street_Line2></Ecom_BillTo_Postal_Street_Line2> <Ecom_BillTo_Postal_City></Ecom_BillTo_Postal_City> <Ecom_BillTo_Telecom_Phone_Number></Ecom_BillTo_Telecom_Phone_Number> <Ecom_BillTo_Postal_PostalCode></Ecom_BillTo_Postal_PostalCode> <Ecom_BillTo_Postal_StateProv></Ecom_BillTo_Postal_StateProv> <Ecom_BillTo_Postal_CountryCode></Ecom_BillTo_Postal_CountryCode>
<Ecom_BillTo_Online_Email></Ecom_BillTo_Online_Email> <Ecom_ShipTo_Postal_Company></Ecom_ShipTo_Postal_Company> <Ecom_ShipTo_Postal_Name></Ecom_ShipTo_Postal_Name> <Ecom_ShipTo_Postal_Street_Line1></Ecom_ShipTo_Postal_Street_Line1> <Ecom_ShipTo_Postal_Street_Line2></Ecom_ShipTo_Postal_Street_Line2> <Ecom_ShipTo_Postal_City></Ecom_ShipTo_Postal_City> <Ecom_ShipTo_Postal_PostalCode></Ecom_ShipTo_Postal_PostalCode> <Ecom_ShipTo_Postal_StateProv></Ecom_ShipTo_Postal_StateProv> <Ecom_ShipTo_Postal_CountryCode></Ecom_ShipTo_Postal_CountryCode> <Ecom_Order_Items> <Ecom_Order_Item> <Name>a5</Name> <Description>a4 desc</description> <Total_Amount>7.50</Total_Amount> <Units>3</Units> <No>a1</No> <Code>a2</Code> <Unit_Amount>6.25</Unit_Amount> </Ecom_Order_Item> </Ecom_Order_Items> <Ecom_ExtraFields> <TXSTATUS>N</TXSTATUS> <ORIGIN> Ce3CdgkcCCrrVK9M+TVLrToJVZ3keaFXDiA/1k8euJE= </ORIGIN> </Ecom_ExtraFields> </PayRequest> <PayResponse> <Ecom_Transaction_Date>2011-05-31 11:35:20.016</Ecom_Transaction_Date> <Ecom_Transaction_Reference_ID> 115100000009 </Ecom_Transaction_Reference_ID> <Ecom_Transaction_ApprovalCode>P09584</Ecom_Transaction_ApprovalCode> <Ecom_Transaction_ErrorCode></Ecom_Transaction_ErrorCode> <Ecom_Transaction_ErrorText></Ecom_Transaction_ErrorText> <Ecom_Transaction_Trace_Audit>000009</Ecom_Transaction_Trace_Audit> <Ecom_Transaction_ReturnCode>00</Ecom_Transaction_ReturnCode>
<Ecom_Transaction_ID>11151-LjUB-1-0225</Ecom_Transaction_ID> <Ecom_ConsumerOrderID> bolumsadece1tanimlibosgonderim </Ecom_ConsumerOrderID> <Ecom_Transaction_Settle_ID>1</Ecom_Transaction_Settle_ID> <Ecom_ExtraFields> <HOSTDATE>1227-083957</HOSTDATE> </Ecom_ExtraFields> </PayResponse> Bölüm Kodu 2 Gönderildiğinde Bölüm kodu sistem tarafından "1" olarak tanımlanmış, fakat üye iş yeri bölüm kodu değerini "2" olarak gönderdiğinde sistemden "Bolum bilgisi uyumsuzlugu. Request'teki bolum bilgisini kontrol ediniz." hata mesajını alır. <PayRequest> <Ecom_Merchant_User_Password>***</Ecom_Merchant_User_Password> <Ecom_System_User_ID>0</Ecom_System_User_ID> <Ecom_Merchant_ID>700100000000</Ecom_Merchant_ID> <Ecom_ConsumerOrderID> bolumsadece1tanimli2gonderim </Ecom_ConsumerOrderID> <Ecom_ConsumerCriteria1></Ecom_ConsumerCriteria1> <Ecom_ConsumerCriteria2></Ecom_ConsumerCriteria2> <Ecom_ConsumerCriteria5>2</Ecom_ConsumerCriteria5> <Ecom_Transaction_Type>Auth</Ecom_Transaction_Type> <Ecom_Payment_Card_Number> 424242:EA4694653CFB4ADCA3E61173652B31799F7487CD99B36 BE249B206182869F4FF:4202:# </Ecom_Payment_Card_Number> <Ecom_Payment_Amount>9.95</Ecom_Payment_Amount> <Ecom_Payment_CurrencyCode>949</Ecom_Payment_CurrencyCode> <Ecom_3D_ECI></Ecom_3D_ECI> <Ecom_3D_CAVV></Ecom_3D_CAVV> <Ecom_3D_XID>7ygW66y74xRPBDcKXTAcw2ZXjQU=</Ecom_3D_XID> <Ecom_APIVersion>JVPosApi v.2.0</ecom_apiversion> <Ecom_Transaction_Comments></Ecom_Transaction_Comments>
<Ecom_Consumer_IP_Address>192.168.0.1</Ecom_Consumer_IP_Address> <Ecom_Payment_Installments></Ecom_Payment_Installments> <Ecom_BillTo_Postal_Company></Ecom_BillTo_Postal_Company> <Ecom_BillTo_Postal_Name>***</Ecom_BillTo_Postal_Name> <Ecom_BillTo_Postal_Street_Line1></Ecom_BillTo_Postal_Street_Line1> <Ecom_BillTo_Postal_Street_Line2></Ecom_BillTo_Postal_Street_Line2> <Ecom_BillTo_Postal_City></Ecom_BillTo_Postal_City> <Ecom_BillTo_Telecom_Phone_Number></Ecom_BillTo_Telecom_Phone_Number> <Ecom_BillTo_Postal_PostalCode></Ecom_BillTo_Postal_PostalCode> <Ecom_BillTo_Postal_StateProv></Ecom_BillTo_Postal_StateProv> <Ecom_BillTo_Postal_CountryCode></Ecom_BillTo_Postal_CountryCode> <Ecom_BillTo_Online_Email></Ecom_BillTo_Online_Email> <Ecom_ShipTo_Postal_Company></Ecom_ShipTo_Postal_Company> <Ecom_ShipTo_Postal_Name></Ecom_ShipTo_Postal_Name> <Ecom_ShipTo_Postal_Street_Line1></Ecom_ShipTo_Postal_Street_Line1> <Ecom_ShipTo_Postal_Street_Line2></Ecom_ShipTo_Postal_Street_Line2> <Ecom_ShipTo_Postal_City></Ecom_ShipTo_Postal_City> <Ecom_ShipTo_Postal_PostalCode></Ecom_ShipTo_Postal_PostalCode> <Ecom_ShipTo_Postal_StateProv></Ecom_ShipTo_Postal_StateProv> <Ecom_ShipTo_Postal_CountryCode></Ecom_ShipTo_Postal_CountryCode> <Ecom_Order_Items> <Ecom_Order_Item> <Name>a5</Name> <Description>a4 desc</description> <Total_Amount>7.50</Total_Amount> <Units>3</Units> <No>a1</No> <Code>a2</Code> <Unit_Amount>6.25</Unit_Amount> </Ecom_Order_Item> </Ecom_Order_Items> <Ecom_ExtraFields> <TXSTATUS>N</TXSTATUS> <ORIGIN>Ce3CdgkcCCrrVK9M+TVLrToJVZ3keaFXDiA/1k8euJE=</ORIGIN> </Ecom_ExtraFields> </PayRequest> <PayResponse>
<Ecom_Transaction_Date>2011-05-31 11:38:52.786</Ecom_Transaction_Date> <Ecom_Transaction_Reference_ID></Ecom_Transaction_Reference_ID> <Ecom_Transaction_ApprovalCode></Ecom_Transaction_ApprovalCode> <Ecom_Transaction_ErrorCode>CORE-2131</Ecom_Transaction_ErrorCode> <Ecom_Transaction_ErrorText> Bolum bilgisi uyumsuzlugu. Request'teki bolum bilgisini kontrol ediniz. </Ecom_Transaction_ErrorText> <Ecom_Transaction_Trace_Audit></Ecom_Transaction_Trace_Audit> <Ecom_Transaction_ReturnCode>99</Ecom_Transaction_ReturnCode> <Ecom_Transaction_ID>11151-Lm2H-1-0245</Ecom_Transaction_ID> <Ecom_ConsumerOrderID></Ecom_ConsumerOrderID> <Ecom_Transaction_Settle_ID></Ecom_Transaction_Settle_ID> <Ecom_ExtraFields> <HOSTDATE>1227-083957</HOSTDATE> </Ecom_ExtraFields> </PayResponse> Bölüm Kodu Sisteme 1 ve 2 Tanımlanmışsa Bölüm Kodu 1 Gönderildiğinde Bölüm kodu sistemde 1 ve 2 olarak tanımlanmış ve üye iş yeri değeri "1" olarak gönderiyorsa işlem onay alır. <PayRequest> <Ecom_Merchant_User_Password>***</Ecom_Merchant_User_Password> <Ecom_System_User_ID>0</Ecom_System_User_ID> <Ecom_Merchant_ID>700100000000</Ecom_Merchant_ID> <Ecom_ConsumerOrderID>bolum1gonderim</Ecom_ConsumerOrderID> <Ecom_ConsumerCriteria1></Ecom_ConsumerCriteria1> <Ecom_ConsumerCriteria2></Ecom_ConsumerCriteria2> <Ecom_ConsumerCriteria5>1</Ecom_ConsumerCriteria5> <Ecom_Transaction_Type>Auth</Ecom_Transaction_Type> <Ecom_Payment_Card_Number> 424242:C6670E8CF5A3AFB26808126387CBDB7C2013D316A0843 57BD281DC466AA8256A:3924:# </Ecom_Payment_Card_Number>
<Ecom_Payment_Amount>9.95</Ecom_Payment_Amount> <Ecom_Payment_CurrencyCode>949</Ecom_Payment_CurrencyCode> <Ecom_3D_ECI></Ecom_3D_ECI> <Ecom_3D_CAVV></Ecom_3D_CAVV> <Ecom_3D_XID>wgLVgfBb1j/m39yiRWlg/ulYXho=</Ecom_3D_XID> <Ecom_APIVersion>JVPosApi v.2.0</ecom_apiversion> <Ecom_Transaction_Comments></Ecom_Transaction_Comments> <Ecom_Consumer_IP_Address>192.168.0.1</Ecom_Consumer_IP_Address> <Ecom_Payment_Installments></Ecom_Payment_Installments> <Ecom_BillTo_Postal_Company></Ecom_BillTo_Postal_Company> <Ecom_BillTo_Postal_Name>***</Ecom_BillTo_Postal_Name> <Ecom_BillTo_Postal_Street_Line1></Ecom_BillTo_Postal_Street_Line1> <Ecom_BillTo_Postal_Street_Line2></Ecom_BillTo_Postal_Street_Line2> <Ecom_BillTo_Postal_City></Ecom_BillTo_Postal_City> <Ecom_BillTo_Telecom_Phone_Number></Ecom_BillTo_Telecom_Phone_Number> <Ecom_BillTo_Postal_PostalCode></Ecom_BillTo_Postal_PostalCode> <Ecom_BillTo_Postal_StateProv></Ecom_BillTo_Postal_StateProv> <Ecom_BillTo_Postal_CountryCode></Ecom_BillTo_Postal_CountryCode> <Ecom_BillTo_Online_Email></Ecom_BillTo_Online_Email> <Ecom_ShipTo_Postal_Company></Ecom_ShipTo_Postal_Company> <Ecom_ShipTo_Postal_Name></Ecom_ShipTo_Postal_Name> <Ecom_ShipTo_Postal_Street_Line1></Ecom_ShipTo_Postal_Street_Line1> <Ecom_ShipTo_Postal_Street_Line2></Ecom_ShipTo_Postal_Street_Line2> <Ecom_ShipTo_Postal_City></Ecom_ShipTo_Postal_City> <Ecom_ShipTo_Postal_PostalCode></Ecom_ShipTo_Postal_PostalCode> <Ecom_ShipTo_Postal_StateProv></Ecom_ShipTo_Postal_StateProv> <Ecom_ShipTo_Postal_CountryCode></Ecom_ShipTo_Postal_CountryCode> <Ecom_Order_Items> <Ecom_Order_Item> <Name>a5</Name> <Description>a4 desc</description> <Total_Amount>7.50</Total_Amount> <Units>3</Units> <No>a1</No> <Code>a2</Code> <Unit_Amount>6.25</Unit_Amount> </Ecom_Order_Item> </Ecom_Order_Items>
<Ecom_ExtraFields> <TXSTATUS>N</TXSTATUS> <ORIGIN> Ce3CdgkcCCrrVK9M+TVLrToJVZ3keaFXDiA/1k8euJE= </ORIGIN> </Ecom_ExtraFields> </PayRequest> <PayResponse> <Ecom_Transaction_Date> 2011-05-31 11:22:05.137 </Ecom_Transaction_Date> <Ecom_Transaction_Reference_ID> 115100000005 </Ecom_Transaction_Reference_ID> <Ecom_Transaction_ApprovalCode> P79004 </Ecom_Transaction_ApprovalCode> <Ecom_Transaction_ErrorCode></Ecom_Transaction_ErrorCode> <Ecom_Transaction_ErrorText></Ecom_Transaction_ErrorText> <Ecom_Transaction_Trace_Audit>000005</Ecom_Transaction_Trace_Audit> <Ecom_Transaction_ReturnCode>00</Ecom_Transaction_ReturnCode> <Ecom_Transaction_ID>11151-LWFC-1-0205</Ecom_Transaction_ID> <Ecom_ConsumerOrderID>bolum1gonderim</Ecom_ConsumerOrderID> <Ecom_Transaction_Settle_ID>1</Ecom_Transaction_Settle_ID> <Ecom_ExtraFields> <HOSTDATE>1227-083957</HOSTDATE> </Ecom_ExtraFields> </PayResponse>
Bölüm Kodu 2 Gönderildiğinde Bölüm kodu sistemde 1 ve 2 olarak tanımlanmış ve üye iş yeri değeri "2" olarak gönderiyorsa işlem onay alır. <PayRequest> <Ecom_Merchant_User_Password>***</Ecom_Merchant_User_Password> <Ecom_System_User_ID>0</Ecom_System_User_ID> <Ecom_Merchant_ID>700100000000</Ecom_Merchant_ID> <Ecom_ConsumerOrderID>bolum2gonderim</Ecom_ConsumerOrderID> <Ecom_ConsumerCriteria1></Ecom_ConsumerCriteria1> <Ecom_ConsumerCriteria2></Ecom_ConsumerCriteria2> <Ecom_ConsumerCriteria5>2</Ecom_ConsumerCriteria5> <Ecom_Transaction_Type>Auth</Ecom_Transaction_Type> <Ecom_Payment_Card_Number> 424242:C6670E8CF5A3AFB26808126387CBDB7C2013D316A0843 57BD281DC466AA8256A:3924:# </Ecom_Payment_Card_Number> <Ecom_Payment_Amount>9.95</Ecom_Payment_Amount> <Ecom_Payment_CurrencyCode>949</Ecom_Payment_CurrencyCode> <Ecom_3D_ECI></Ecom_3D_ECI> <Ecom_3D_CAVV></Ecom_3D_CAVV> <Ecom_3D_XID>wgLVgfBb1j/m39yiRWlg/ulYXho=</Ecom_3D_XID> <Ecom_APIVersion>JVPosApi v.2.0</ecom_apiversion> <Ecom_Transaction_Comments></Ecom_Transaction_Comments> <Ecom_Consumer_IP_Address>192.168.0.1</Ecom_Consumer_IP_Address> <Ecom_Payment_Installments></Ecom_Payment_Installments> <Ecom_BillTo_Postal_Company></Ecom_BillTo_Postal_Company> <Ecom_BillTo_Postal_Name>***</Ecom_BillTo_Postal_Name> <Ecom_BillTo_Postal_Street_Line1></Ecom_BillTo_Postal_Street_Line1> <Ecom_BillTo_Postal_Street_Line2></Ecom_BillTo_Postal_Street_Line2> <Ecom_BillTo_Postal_City></Ecom_BillTo_Postal_City> <Ecom_BillTo_Telecom_Phone_Number></Ecom_BillTo_Telecom_Phone_Number> <Ecom_BillTo_Postal_PostalCode></Ecom_BillTo_Postal_PostalCode> <Ecom_BillTo_Postal_StateProv></Ecom_BillTo_Postal_StateProv> <Ecom_BillTo_Postal_CountryCode></Ecom_BillTo_Postal_CountryCode> <Ecom_BillTo_Online_Email></Ecom_BillTo_Online_Email> <Ecom_ShipTo_Postal_Company></Ecom_ShipTo_Postal_Company> <Ecom_ShipTo_Postal_Name></Ecom_ShipTo_Postal_Name>
<Ecom_ShipTo_Postal_Street_Line1></Ecom_ShipTo_Postal_Street_Line1> <Ecom_ShipTo_Postal_Street_Line2></Ecom_ShipTo_Postal_Street_Line2> <Ecom_ShipTo_Postal_City></Ecom_ShipTo_Postal_City> <Ecom_ShipTo_Postal_PostalCode></Ecom_ShipTo_Postal_PostalCode> <Ecom_ShipTo_Postal_StateProv></Ecom_ShipTo_Postal_StateProv> <Ecom_ShipTo_Postal_CountryCode></Ecom_ShipTo_Postal_CountryCode> <Ecom_Order_Items> <Ecom_Order_Item> <Name>a5</Name> <Description>a4 desc</description> <Total_Amount>7.50</Total_Amount> <Units>3</Units> <No>a1</No> <Code>a2</Code> <Unit_Amount>6.25</Unit_Amount> </Ecom_Order_Item> </Ecom_Order_Items> <Ecom_ExtraFields> <TXSTATUS>N</TXSTATUS> <ORIGIN>Ce3CdgkcCCrrVK9M+TVLrToJVZ3keaFXDiA/1k8euJE=</ORIGIN> </Ecom_ExtraFields> </PayRequest> <PayResponse> <Ecom_Transaction_Date> 2011-05-31 11:22:05.137 </Ecom_Transaction_Date> <Ecom_Transaction_Reference_ID> 115100000005 </Ecom_Transaction_Reference_ID> <Ecom_Transaction_ApprovalCode> P79004 </Ecom_Transaction_ApprovalCode> <Ecom_Transaction_ErrorCode></Ecom_Transaction_ErrorCode> <Ecom_Transaction_ErrorText></Ecom_Transaction_ErrorText> <Ecom_Transaction_Trace_Audit>000005</Ecom_Transaction_Trace_Audit> <Ecom_Transaction_ReturnCode>00</Ecom_Transaction_ReturnCode> <Ecom_Transaction_ID>11151-LWFC-1-0205</Ecom_Transaction_ID>
<Ecom_ConsumerOrderID>bolum1gonderim</Ecom_ConsumerOrderID> <Ecom_Transaction_Settle_ID>1</Ecom_Transaction_Settle_ID> <Ecom_ExtraFields> <HOSTDATE>1227-083957</HOSTDATE> </Ecom_ExtraFields> </PayResponse> Bölüm Kodu 3 Gönderildiğinde Bölüm kodu sistemde 1 ve 2 olarak tanımlanmış, fakat üye iş yeri değeri "3" olarak gönderiyorsa sistem "Bolum bilgisi uyumsuzlugu. Request'teki bolum bilgisini kontrol ediniz." hatası döner. <PayRequest> <Ecom_Merchant_User_Password>***</Ecom_Merchant_User_Password> <Ecom_System_User_ID>0</Ecom_System_User_ID> <Ecom_Merchant_ID>700100000000</Ecom_Merchant_ID> <Ecom_ConsumerOrderID>bolum3gonderim</Ecom_ConsumerOrderID> <Ecom_ConsumerCriteria1></Ecom_ConsumerCriteria1> <Ecom_ConsumerCriteria2></Ecom_ConsumerCriteria2> <Ecom_ConsumerCriteria5>3</Ecom_ConsumerCriteria5> <Ecom_Transaction_Type>Auth</Ecom_Transaction_Type> <Ecom_Payment_Card_Number> 424242:B09D16F6BA18C30B698F37F9B6101A7571C3AE5270911 B7B5F26FF786C252F3D:3642:# </Ecom_Payment_Card_Number> <Ecom_Payment_Amount>9.95</Ecom_Payment_Amount> <Ecom_Payment_CurrencyCode>949</Ecom_Payment_CurrencyCode> <Ecom_3D_ECI></Ecom_3D_ECI> <Ecom_3D_CAVV></Ecom_3D_CAVV> <Ecom_3D_XID>58xNXQOhl6eveemQHU6tfQDL8Uw=</Ecom_3D_XID> <Ecom_APIVersion>JVPosApi v.2.0</ecom_apiversion> <Ecom_Transaction_Comments></Ecom_Transaction_Comments> <Ecom_Consumer_IP_Address>192.168.0.1</Ecom_Consumer_IP_Address> <Ecom_Payment_Installments></Ecom_Payment_Installments> <Ecom_BillTo_Postal_Company></Ecom_BillTo_Postal_Company> <Ecom_BillTo_Postal_Name>***</Ecom_BillTo_Postal_Name> <Ecom_BillTo_Postal_Street_Line1></Ecom_BillTo_Postal_Street_Line1>
<Ecom_BillTo_Postal_Street_Line2></Ecom_BillTo_Postal_Street_Line2> <Ecom_BillTo_Postal_City></Ecom_BillTo_Postal_City> <Ecom_BillTo_Telecom_Phone_Number></Ecom_BillTo_Telecom_Phone_Number> <Ecom_BillTo_Postal_PostalCode></Ecom_BillTo_Postal_PostalCode> <Ecom_BillTo_Postal_StateProv></Ecom_BillTo_Postal_StateProv> <Ecom_BillTo_Postal_CountryCode></Ecom_BillTo_Postal_CountryCode> <Ecom_BillTo_Online_Email></Ecom_BillTo_Online_Email> <Ecom_ShipTo_Postal_Company></Ecom_ShipTo_Postal_Company> <Ecom_ShipTo_Postal_Name></Ecom_ShipTo_Postal_Name> <Ecom_ShipTo_Postal_Street_Line1></Ecom_ShipTo_Postal_Street_Line1> <Ecom_ShipTo_Postal_Street_Line2></Ecom_ShipTo_Postal_Street_Line2> <Ecom_ShipTo_Postal_City></Ecom_ShipTo_Postal_City> <Ecom_ShipTo_Postal_PostalCode></Ecom_ShipTo_Postal_PostalCode> <Ecom_ShipTo_Postal_StateProv></Ecom_ShipTo_Postal_StateProv> <Ecom_ShipTo_Postal_CountryCode></Ecom_ShipTo_Postal_CountryCode> <Ecom_Order_Items> <Ecom_Order_Item> <Name>a5</Name> <Description>a4 desc</description> <Total_Amount>7.50</Total_Amount> <Units>3</Units> <No>a1</No> <Code>a2</Code> <Unit_Amount>6.25</Unit_Amount> </Ecom_Order_Item> </Ecom_Order_Items> <Ecom_ExtraFields> <TXSTATUS>N</TXSTATUS> <ORIGIN>Ce3CdgkcCCrrVK9M+TVLrToJVZ3keaFXDiA/1k8euJE=</ORIGIN> </Ecom_ExtraFields> </PayRequest> <PayResponse> <Ecom_Transaction_Date>2011-05-31 11:31:22.242</Ecom_Transaction_Date> <Ecom_Transaction_Reference_ID></Ecom_Transaction_Reference_ID> <Ecom_Transaction_ApprovalCode></Ecom_Transaction_ApprovalCode> <Ecom_Transaction_ErrorCode>CORE-2131</Ecom_Transaction_ErrorCode> <Ecom_Transaction_ErrorText>
Bolum bilgisi uyumsuzlugu. Request'teki bolum bilgisini kontrol ediniz. </Ecom_Transaction_ErrorText> <Ecom_Transaction_Trace_Audit></Ecom_Transaction_Trace_Audit> <Ecom_Transaction_ReturnCode>99</Ecom_Transaction_ReturnCode> <Ecom_Transaction_ID>11151-LfWC-1-0213</Ecom_Transaction_ID> <Ecom_ConsumerOrderID></Ecom_ConsumerOrderID> <Ecom_Transaction_Settle_ID></Ecom_Transaction_Settle_ID> <Ecom_ExtraFields> <HOSTDATE>1227-083957</HOSTDATE> </Ecom_ExtraFields> </PayResponse> Dönen Değerlerin Raporlar Ekranındaki Görünümü
Maximum Fırsat Api Entegrasyonu Maxi Puan Sorgulama Api Entegrasyonu Maxi puan sorgulama Api entegrasyon örneği aşağıdaki gibidir; Maxi Puan Sorgulama İsteği: <CC5Request> <Name>esttest</Name> <Password>esttest</Password> <ClientId>740600402</ClientId> <Mode>P</Mode> <OrderId></OrderId> <Type>Auth</Type> <Number>4543********1132</Number> <Expires>06/07</Expires> <Cvv2Val></Cvv2Val> <Total></Total> <Currency>949</Currency> <BillTo></BillTo> <ShipTo></ShipTo> <Extra> <MAXIPUANSORGU>MAXIPUANSORGU</MAXIPUANSORGU> </Extra> </CC5Request> Maxi Puan Sorgulama Yanıtı: <CC5Response> <ErrMsg></ErrMsg> <Extra> <MAXIPUAN>9850.58</MAXIPUAN> <BILETTUTAR>29551.74</BILETTUTAR> </Extra> </CC5Response>
Maxi Puan Kullanma Api Entegrasyonu Maxi puan kullanma Api entegrasyon örneği aşağıdaki gibidir; Maxi Puan Kullanma İsteği: <CC5Request> <Name>esttest</Name> <Password>esttest</Password> <ClientId>740600402</ClientId> <Mode>P</Mode> <OrderId>TEST-01</OrderId> <Type>Auth</Type> <Number>4543********1132</Number> <Expires>06/07</Expires> <Cvv2Val></Cvv2Val> <Total>30</Total> <Currency>949</Currency> <BillTo></BillTo> <ShipTo></ShipTo> <Extra> <MAXIPUANSORGU>MAXIPUANSORGU</MAXIPUANSORGU> </Extra> </CC5Request> Maxi Puan Kullanma Yanıtı: <CC5Response> <OrderId>TEST-01</OrderId> <GroupId>TEST-01</GroupId> <Response>Approved</Response> <AuthCode>M62077</AuthCode> <HostRefNum>628618172412</HostRefNum> <ProcReturnCode>00</ProcReturnCode> <TransId>452dfbf8-0136-3000-0029-0003ba16888b</TransId> <ErrMsg></ErrMsg> <Extra> <KALANMAXIPUAN>149.41</KALANMAXIPUAN> <HOSTMSG>KALAN MAXI: 149.41 BORC TUTR: 0.00</HOSTMSG>
<SETTLEID>2</SETTLEID> <BORCTUTAR>0.0</BORCTUTAR> <TRXDATE>20061013 15:14:46</TRXDATE> </Extra> </CC5Response> RRN ile İade Api Entegrasyonu Bu işlem tipi yetkiye bağlıdır. Yetkili Üye İşyeri kullanıcıları yapabilir. Detay bilgi için bankanıza başvurunuz. Bu yetki için bankanızla iletişime geçmeniz gerekmektedir. RRN ile iade prosedürü, İş Bankası Safir SanalPos sistemi üzerinde, RRN ve tutar ile, orijinal işlem kaydı olmadan, referanssız iade gerçekleştirilmesidir. İadesi yapılacak işleme dair işlem tutarı ve referans numarası bilgileri girilmelidir. Para birimi ve bölüm kodu alanları ilgili işyeri için tanımlanmış olan bilgileri içeren birer seçme kutusu halinde getirilecektir. RRN ile İade İsteği: <PayRequest> <Ecom_Merchant_User_Password>***</Ecom_Merchant_User_Password> <Ecom_System_User_ID>106839</Ecom_System_User_ID> <Ecom_Merchant_ID>700655010010</Ecom_Merchant_ID> <Ecom_Transaction_Type>Credit</Ecom_Transaction_Type> <Ecom_Payment_Amount>42,53</Ecom_Payment_Amount> <Ecom_Payment_CurrencyCode>949</Ecom_Payment_CurrencyCode> <Ecom_APIVersion>JVPosApi v.2.0</ecom_apiversion> <Ecom_ExtraFields> <RRN>123456789012</RRN> <ORIGIN>rMUzPoErgnlGLaoV5ek/RKaqtYgQ1IeC8XJBBz6hcHk=</ORIGIN> </Ecom_ExtraFields> </PayRequest>
RRN ile İade Yanıtı: <PayResponse> <Response>Approved</Response> <AuthCode>M62077</AuthCode> <HostRefNum>628618172412</HostRefNum> <ProcReturnCode>00</ProcReturnCode> <TransId>452dfbf8-0136-3000-0029-0003ba16888b</TransId> <ErrMsg></ErrMsg> <Extra> <TRXDATE>20061013 15:14:46</TRXDATE> </Extra> </PayResponse> İndirimli İşlemEntegrasyonu Satış işlemlerinde İndirim verilmesi tamamen İşbankası nın sorumluluğundadır. Burada Safir SanalPos Sistemi nin hiçbir opsiyonu yoktur. İndirimişlemlerinde, Satışyapıldıktansonra, İşbankası tarafından dönen cevapta eğer ilgili satış için herhangi bir indirim mevcutsa, İndirimli tutar bildirilmektedir. İndirimli İşlem Api Entegrasyonu: Satış Isteği <?xml version="1.0" encoding="utf-8"?> <PayRequest> <Ecom_Merchant_User_Name>User</Ecom_Merchant_User_Name> <Ecom_Merchant_User_Password>****</Ecom_Merchant_User_Password> <Ecom_Merchant_ID>700656522091</Ecom_Merchant_ID> <Ecom_ConsumerOrderID></Ecom_ConsumerOrderID> <Ecom_Transaction_Type>Auth</Ecom_Transaction_Type> <Ecom_Payment_Card_Number>4242424242424242</Ecom_Payment_Card_Number> <Ecom_Payment_Card_ExpDate_Month>12</Ecom_Payment_Card_ExpDate_Month> <Ecom_Payment_Card_ExpDate_Year>13</Ecom_Payment_Card_ExpDate_Year> <Ecom_Payment_Card_Verification>000</Ecom_Payment_Card_Verification> <Ecom_Payment_Amount>10.01</Ecom_Payment_Amount> <Ecom_Payment_CurrencyCode>949</Ecom_Payment_CurrencyCode>
<Ecom_ExtraFields></Ecom_ExtraFields> </PayRequest> İndirimli Satış Cevabı İlgili İndirimli Satış Cevabı nda indirimli tutar üye iş yerine aşağıdaki şekilde Safir SanalPos sistemi tarafından geri dönülür. <?xml version="1.0" encoding="iso-8859-9"?> <PayResponse> <Ecom_Transaction_Date>2013-02-05 11:57:35.566</Ecom_Transaction_Date> <Ecom_Transaction_Reference_ID>303600000288</Ecom_Transaction_Reference_ID> <Ecom_Transaction_ApprovalCode>P59489</Ecom_Transaction_ApprovalCode> <Ecom_Transaction_ErrorCode></Ecom_Transaction_ErrorCode> <Ecom_Transaction_ErrorText></Ecom_Transaction_ErrorText> <Ecom_Transaction_Trace_Audit>000288</Ecom_Transaction_Trace_Audit> <Ecom_Transaction_ReturnCode>00</Ecom_Transaction_ReturnCode> <Ecom_Transaction_ID>13036L7kA10004</Ecom_Transaction_ID> <Ecom_ConsumerOrderID>ORDER-13036L7jG10002</Ecom_ConsumerOrderID> <Ecom_Transaction_Settle_ID>20101214</Ecom_Transaction_Settle_ID> <Ecom_ExtraFields> <INDIRIMLITUTAR>1.95</INDIRIMLITUTAR> <HOSTDATE>0205-115736</HOSTDATE> </Ecom_ExtraFields> </PayResponse> İndirimli İşlem Rapor Ekranı Entegrasyonu : İndirimli olarak gerçekleşen bir sipariş, aşağıda görüldüğü üzere ilk tutar ve net tutar bölümünden görülmektedir. Aynı şekilde, soldaki sipariş numarasına tıklandığında, Sipariş Bilgileri sayfasında İşlem Tipi bölümünde İndirimli İşlem (aşağıda görülmektedir) yazmaktadır.
TCKN ile Kontür Yükleme Entegrasyonu TCKN, Telefon No, Yükleme miktarı (TL veya Dakika olarak) bilgisi kullanılarak müşterilerin kartlarındaki maxipuanları ile telefonlarına yükleme yapabilmeleri sağlanacaktır. PAN alanına TCKN numarası 11 hane olarak, PHONENO alanına kontür yüklenmek istenen telefon numarası 10 hane olarak, PANTYPE alanına ise T değeri girilmelidir. PHONETOPUPUNIT alanı T (TL) veya D (Dakika) değerlerinden birini alabilir. Satış isteği <?xml version="1.0" encoding="utf-8"?> <CC5Request> <Name>user</Name> <Password>***</Password> <ClientId>700121212</ClientId> <Mode>P</Mode> <Type>Auth</Type> <Total>10.01</Total> <Currency>949</Currency> <Extra> <PAN>123456***8912</PAN> <PANTYPE>T</PANTYPE> <PHONENO>5414909090</PHONENO> <PHONETOPUPUNIT>D</PHONETOPUPUNIT> <PHONETOPUPAMOUNT>100</PHONETOPUPAMOUNT> </Extra> </CC5Request> Satış cevabı <?xml version="1.0" encoding="iso-8859-9"?> <CC5Response> <OrderId>ORDER-13058PfEF10002</OrderId> <GroupId>ORDER-13058PfEF10002</GroupId> <Response>Approved</Response> <AuthCode>P50166</AuthCode> <HostRefNum>305800000060</HostRefNum> <ProcReturnCode>00</ProcReturnCode> <TransId>13058PfKF10004</TransId> <ErrMsg></ErrMsg>
<Extra> <SETTLEID>1</SETTLEID> <TRXDATE>20130227 15:30:34</TRXDATE> <ERRORCODE></ERRORCODE> <HOSTDATE>0227-153115</HOSTDATE> <NUMCODE>00</NUMCODE> </Extra> </CC5Response> Betek Entegrasyonu Üyeişyeri betek referans numarası ve kampanya numarasını göndererek işlemi gerçekleştirebilir. Referans numarası 9 karakterden, kampanya numarası 8 karakterden uzun olmamalıdır. Betek entegrasyon örneği aşağıdaki gibidir; Satış isteği <?xml version="1.0" encoding="utf-8"?> <CC5Request> <Name>user</Name> <Password>***</Password> <ClientId>700121212</ClientId> <Mode>P</Mode> <Type>Auth</Type> <Total>10.01</Total> <Currency>949</Currency> <Extra> <BETEKKAMPANYAID>12312312</BETEKKAMPANYAID> <BETEKREFERANSID>178978978</BETEKREFERANSID> </Extra> </CC5Request> Satış cevabı <?xml version="1.0" encoding="iso-8859-9"?> <CC5Response> <OrderId>ORDER-13058PfEF10002</OrderId>
<GroupId>ORDER-13058PfEF10002</GroupId> <Response>Approved</Response> <AuthCode>P50166</AuthCode> <HostRefNum>305800000060</HostRefNum> <ProcReturnCode>00</ProcReturnCode> <TransId>13058PfKF10004</TransId> <ErrMsg></ErrMsg> <Extra> <SETTLEID>1</SETTLEID> <TRXDATE>20130227 15:30:34</TRXDATE> <ERRORCODE></ERRORCODE> <HOSTDATE>0227-153115</HOSTDATE> <NUMCODE>00</NUMCODE> </Extra> </CC5Response> SGK Ödemeleri, Komisyonlu Ödeme Entegrasyonu Üyeişyeri SGK Ödemelerinde, komisyon tutarını göndererek işlemi gerçekleştirebilir. SGK komisyon tutarı nümerik olmak zorundadır. SGK Ödemeleri, komisyonlu ödeme entegrasyon örneği aşağıdaki gibidir; <?xml version="1.0" encoding="utf-8"?> <CC5Request> <Name>user</Name> <Password>***</Password> <ClientId>700121212</ClientId> <Mode>P</Mode> <Type>Auth</Type> <Total>700</Total> <Currency>949</Currency> <Extra> <SGKKOMISYON>7.75</SGKKOMISYON> </Extra> </CC5Request>
Satış cevabı <?xml version="1.0" encoding="iso-8859-9"?> <CC5Response> <OrderId>ORDER-13058PfEF10002</OrderId> <GroupId>ORDER-13058PfEF10002</GroupId> <Response>Approved</Response> <AuthCode>P50166</AuthCode> <HostRefNum>305800000060</HostRefNum> <ProcReturnCode>00</ProcReturnCode> <TransId>13058PfKF10004</TransId> <ErrMsg></ErrMsg> <Extra> <SETTLEID>1</SETTLEID> <TRXDATE>20130227 15:30:34</TRXDATE> <ERRORCODE></ERRORCODE> <HOSTDATE>0227-153115</HOSTDATE> <NUMCODE>00</NUMCODE> </Extra> </CC5Response> Ön Ödemeli Kart Entegrasyonu İşyeri ön ödemeli (prepaid) karta bakiye yükleme işlemini gerçekleştirebilir. Ön ödemeli karta bakiye yüklenecek olan kart için provizion alınır; başarılı provizyon sonrası ön ödemeli karta bakiye yükleme işlemi gerçekleştirilir. İşlem Akışı: 1. Ön ödemeli karta bakiye yükleme için sorgulama yapılır. Dönüş mesajında RRN bilgisi yer almaktadır. 2. RRN numarası ile Satış(RRN) gönderilerek, kredi kartından provizyon gerçekleştirilir. Sonuç işyerine dönülür. 3. İkinci adım başarılı tamamlanmış ise Konfirmasyon(RRN) mesajı gönderilir. Başarısız sonuçlanması durumunda, onay alınana kadar aralıklarla denenir. 4. Konfirmasyon adımı günsonu saatine kadar onay alamazsa, denemeler bitirilir ve günsonu yapılır. Bakiye Yükleme Mesaj Formatı Bakiye yükleme mesajında Prepaid kart no PREPAIDCARD ekstra alanında gönderilir. İşlemin sorgu tipini belirtmek için PREPAIDTRANSFERQUERY ekstrası kullanılır. Örnek bakiye yükleme sorgulama mesajı aşağıda verilmiştir.
Bakiye Yükleme Sorgulama İstek Mesajı <?xml version="1.0" encoding="utf-8"?> <CC5Request> <Name>admin</Name> <Password>TEST1234</Password> <ClientId>700012345</ClientId> <OrderId></OrderId> <GroupId></GroupId> <Mode>P</Mode> <Type>PreAuth</Type> <Number>4111111111111111</Number> <Expires>10.2025</Expires> <Cvv2Val>000</Cvv2Val> <Total>1.01</Total> <Currency>949</Currency> <Extra> <PREPAIDTRANSFERQUERY>PREPAIDQUERY</PREPAIDTRANSFERQUERY> <PREPAIDCARD>4242424242424242</PREPAIDCARD> </Extra> </CC5Request> Bakiye Yükleme Sorgulama Cevap Mesajı <CC5Response> <OrderId>ORDER-13249KaWI10002</OrderId> <Response>Approved</Response> <AuthCode>P94841</AuthCode> <ProcReturnCode>00</ProcReturnCode> <TransId>13249KaYI10004</TransId> <ErrMsg/> <Extra> <SETTLEID>46</SETTLEID> <TRXDATE>20130906 10:26:16</TRXDATE> <ERRORCODE/> <HOSTDATE>0906-102625</HOSTDATE> <NUMCODE>00</NUMCODE> <RRN>120000007894</RRN> </Extra>
</CC5Response> Bakiye Yükleme Satış Mesaj Formatı Bakiye yükleme sorgulama mesajına gelen cevap başarılı ise, dönen cevaptaki RRN değerini kullanarak bakiye sorgulama satış mesajı gönderilir. Bu mesajda işlem tipi PreAuth olmalıdır. Bakiye Yükleme Satış İstek Mesajı <?xml version="1.0" encoding="utf-8"?> <CC5Request> <Name>admin</Name> <Password>TEST1234</Password> <ClientId>700012345</ClientId> <OrderId></OrderId> <GroupId></GroupId> <Mode>P</Mode> <Type>PreAuth</Type> <Number>4111111111111111</Number> <Expires>10.2025</Expires> <Cvv2Val>000</Cvv2Val> <Total>1.01</Total> <Currency>949</Currency> <Extra> <PREPAIDTRANSFER>PREPAIDQUERY</PREPAIDTRANSFER> <PREPAIDCARD>4242424242424242</PREPAIDCARD> <RRN>120000007894</RRN> </Extra> </CC5Request> Bakiye yükleme satışı başarılı olduğunda system otomatik olarak konfirmasyon mesajını yollayacaktır. Bakiye Yükleme Satış Cevap Mesajı <CC5Response> <OrderId>ORDER-13249KaWI10002</OrderId> <Response>Approved</Response> <AuthCode>P94841</AuthCode>
<ProcReturnCode>00</ProcReturnCode> <TransId>13249KaYI10004</TransId> <ErrMsg/> <Extra> <SETTLEID>46</SETTLEID> <TRXDATE>20130906 10:26:16</TRXDATE> <ERRORCODE/> <HOSTDATE>0906-102625</HOSTDATE> <NUMCODE>00</NUMCODE> </Extra> </CC5Response> Üye İşyeri Rapor Ekranları Üye İşyeri Rapor ekranları kullanılarak da Prepaid Kart bakiye yükleme sorgulama ve satış işlemleri yapılabilir. İlgili ekrana erişmek için Manuel Pos > Prepaid Kart Bakiye Yükleme linkini tıklayın: Zorunlu alanları doldurarak (Kart numarası, Prepaid Kart numarası vb.) Sorgula butonuna basınız. Bu esnada Prepaid Kart Bakiye Yükleme sorgulama mesajı bankaya gönderilecektir:
Bakiye yükleme satışı için sorgulama sonuç sayfasındaki Onayla butonunu tıklayınız: Bakiye yükleme satış cevabı ekrana basılacaktır: