Akbank SanalPos Xml Çözümü Kurulum




Yüklə 30.1 Kb.
tarix26.04.2016
ölçüsü30.1 Kb.
Akbank SanalPos Xml Çözümü
Kurulum:
XML çözümünü kullanmak için herhangi bir DLL ya da Exe yüklemeye gerek yoktur. Bu çözümü kullanmak için Windows 2000 Server üzerinde Service Pack 2 yada üzeri bir sürümün yüklü olması yeterlidir.
Sanal Posa nasıl işlem gönderilir?
Sanal Posa işlem gönderebilmek için CC5Request XML dokümanının doğru şekilde hazırlanması gerekmektedir.

Bu XML hazırlandıktan sonra https://www.sanalakpos.com/servlet/cc5ApiServer adresine SSL bağlantı kurularak post edilir. Gönderilen kredi kartı işlemi Akbank provizyon merkezi tarafından işlem görür ve işlemin sonucu CC5Response XML içinde üye işyerine döndürülür. Üye işyeri bu geri dönen XML dokümanındaki sonuca göre yapması gereken işlemleri yapar.

Gönderilen ve alınan XML dokümanlarının hiyerarşisi Ek A bölümünde verilmiştir.

CC5Request XML


Gönderilen parametreler.

Name (String) : Kullanıcı adı banka tarafından üye işyerine verilir.

Password (String) : Şifre banka tarafından üye işyerine verilir.

ClientId (String) : Mağaza numarası banka tarafından üye işyerine verilir.

OrderId (String) : Sipariş numarası üye işyeri tarafından üretilir, eğer boş gönderilirse banka tarafından üretilir.

Type (String) : İşlem tipi işlem tiplerinin açıklamaları Ek B de verilmiştir.

Number (String) : Kredi kartı numarası

Expires (String) : Son kullanma tarihi MM/YY formatında olmalıdır.

Cvv2Val (String) : Güvenlik numarası, Kredi kartının arkasındaki üç haneli numaradır.

Total (String) : İşlem yapılacak toplam tutar.

Taksit (String) : Eğer taksitli işlem ise kaç taksit olacağı bu parametre ile verilir. Eğer taksitli işlem değilse bu parametre hiç gönderilmemelidir.

Currency (String) : Para birimi YTL için 949, USD için 840 , EUR için 978 yazılmalıdır.

UserId (String) : Müşteri kodu eğer üye işyeri kendi müşterilerine bir kod veriyorsa bu kodu user id alanından gönderebilir.

email (String) : Müşterinin e-mail adresi.

BillTo * : Bu bölüm müşterinin fatura bilgileri sanal posa gönderilmek isteniyorsa set edilmelidir.


Name (String) : Fatura üzerindeki isim.

Street1 (String) : Fatura üzerindeki birinci adres satırı.

Street2 (String) : Fatura üzerindeki ikinci adres satırı.

Street3 (String) : Fatura üzerindeki üçüncü adres satırı.

City (String) : Fatura adresi için şehir alanı.

PostalCode (String) : Fatura adresi için posta kodu alanı.

TelVoice (String) : Fatura için telefon alanı.

ShipTo * Bu bölüm müşterinin teslimat bilgileri sanal posa gönderilmek isteniyorsa set edilmelidir.


Name (String) : Teslimat üzerindeki isim.

Street1 (String) : Teslimat üzerindeki birinci adres satırı.

Street2 (String) : Teslimat üzerindeki ikinci adres satırı.

Street3 (String) : Teslimat üzerindeki üçüncü adres satırı.

City (String) : Teslimat adresi için şehir alanı.

PostalCode (String) : Teslimat adresi için posta kodu alanı.

TelVoice (String) : Teslimat bilgisi için telefon alanı.
|

OrderItemList Bu bölüm satılan ürüne ait bilgiler sanal posa gönderilmek isteniyorsa gönderilmelidir.

OrderItem *

ItemNumber (String) : Ürün numarası

ProductCode (String) : Ürün kodu

Qty (String) : Ürün adedi

Desc (String) : Ürün açıklaması

Id (String) : Ürün id kodu

Price (String) : Ürünün birim fiyatı

Total (String) : Ürünün toplam fiyatı

CC5Response xml

Geri Dönen Parametreler


OrderId (String) : Sipariş numarası

GroupId (String) : Sipariş grup numarası

Response (String) : İşlemin sonucu; Approved ise işlem onaylanmış , Declined ise işlem reddedilmiş , Error ise işelm sırasında bir hata oluşmuş ve işlem reddedilmiştir.

AuthCode (String) : Provizyon numarası

HostRefNum (String) :Referans numarası

ProcReturnCode (String) : İşlemin dönüş kodu Eğere onaylı bir işlemse 00 reddedilen bir işlem ise 2 haneli hata kodunu döndürür.

TransId (String) :İşlem numarası

ErrMsg (String) : Hata mesajı


+-- Extra * : Extra alanı Bonus Kullanma ve Bonus kazandırma işlemleri yapıldığında geri döner.

Geri dönen extra alanların açıklamaları EK C de verilmiştir.




EK A



CC5Request

|__ Name (String)

|__ Password (String)

|__ ClientId (String)

|__ OrderId (String)

|__ Type (String)

|__ Number (String)

|__ Expires (String)

|__ Cvv2Val (String)

|__ Total (String)

|__ Taksit (String)

|__ Currency (String)

|__ UserId (String)

|__ email (String)

+-- BillTo *

| |__ Name (String)

| |__ Street1 (String)

| |__ Street2 (String)

| |__ Street3 (String)

| |__ City (String)

| |__ PostalCode (String)

| |__ TelVoice (String)

|

+-- ShipTo *

| |__ Name (String)

| |__ Street1 (String)

| |__ Street2 (String)

| |__ Street3 (String)

| |__ City (String)

| |__ PostalCode (String)

| |__ TelVoice (String)

|

| +-- OrderItemList

| +-- OrderItem *

| |__ ItemNumber (String)

| |__ ProductCode (String)

| |__ Qty (String)

| |__ Desc (String)

| |__ Id (String)

| |__ Price (String)

| |__ Total (String)

|

+-- Extra *

| |__ Extra1 (String)

| |__ Extra2 (String)

|
CC5Response

|__ OrderId (String)

|__ GroupId (String)

|__ Response (String)

|__ AuthCode (String)

|__ HostRefNum (String)

|__ ProcReturnCode (String)

|__ TransId (String)

|__ ErrMsg (String)

+-- Extra *

| |__ Extra1 (String)

| |__ Extra2 (String)

|
EK B
Charge Type (İşlem tipleri)

Provizyon (PreAuth)


Karttan provizyon alınır ve kart limiti işlemi yapan üye işyeri adına bloke edilir. Kredi kartı sahibinin limiti provizyon alınan tutar kadar azalır. Provizyon işlemi işyeri tarafından onaylanmadıkça üye işyeri hesabına hesaplara yansımaz, kredi kartı sahibinin ekstresinde görünmez

İşyeri Onayı (PostAuth)


Provizyon alınmış işlemi onaylamak ve para transferini gerçekleştirmek için kullanılır.

İşyeri onayı verilen işlem otomatik olarak saat 22:00’de gerçekleşen günsonu işleminden sonra muhasebeleşerek işyeri hesabına ve kredi kartı hesabına yansır.

Provizyonlara onay verilmez ise kredi kartına konan bloke tutar maksimum 14 gün sonra kalkar.

Satış (Auth)

Provizyon ve işyeri onayı işlemlerini aynı anda yapar. Satış işlemi otomatik olarak saat 22:00’de gerçekleşen gün sonu işleminden sonra muhasebeleşerek , üye işyeri hesabına ve kredi kartı hesabına yansır.




Provizyon İptali (Void)

Onay almış Provizyon işlemini iptal eder. Provizyon iptali işlemi yalnızca gün içerisinde yapılmış provizyonlar için yapılabilir. Provizyon iptali yapıldığında kredi kartı limitine konan bloke tutar serbest kalır.Provizyon ve provizyon iptali işlemleri kredi kartı ekstresinde görünmez.

Üzerinden gün geçmiş bir provizyonu kaldırmak için önce o provizyona onay vermeli ve ardından iade işlemini yapmalısınız.

İşyeri Onayı İptali (Void)

Gün içerisinde yapılan capture işlemini iptal eder. İptal edilen capture işlemleri hesaplara yansımaz.




Satış iptali (Void)

Onay almış satış işlemini iptal eder. İptal edilen satış işlemi kredi kart ekstresine yansımaz.




İade (Credit)

İade işlemi işyeri onayı yapılmış siparişlere ve satış işlemlerine yapılabilir.



Taksitli satışlar gün içerisinde iade edilemez ancak ertesi gün iade edilebilir.

Parapuan kullanılarak yapılan satışlar online olarak iade edilemez bu işlemleri iade etmek için şubenizle görüşmelisiniz.


Verilənlər bazası müəlliflik hüququ ilə müdafiə olunur ©www.azrefs.org 2016
rəhbərliyinə müraciət

    Ana səhifə