Topup Credit Card (Deposit)

URL

Kullanıcının kredi kartıyla kendi cüzdanına bakiye yüklemek için kullanılan endpoint ve http metod bilgisi aşağıda verilmiştir.

TopupCredit metodunu çağırmadan önce Sipay posundan tahsilatın yapılmış olması gerekmektedir. Akış aşağıdaki gibidir :

  • Tenanta bir POS hesabı açılır.
  • İlgili ekrana Sipay POS apileri bağlanır. (https://apidocs.sipay.com.tr)
  • Pos'dan tahsilat gerçekleşir.
  • Pos tarafındaki "invoice_id" değeri wallet tarafındaki TopupCredit servisinin "ext_transaction_id" parametresine atanır.
  • Wallet uygulaması pos uygulaması ile haberleşip ödemeyi doğruladıktan sonra tutar cüzdana yatar.

NOT1 : Bu servisin kullanımı Kyc seviyesinde herhangi bir değişiklik yapmamaktadır!

NOT2 : Kullanıcının KYC limiti üzerinde TopupCredit yapıp yapmadığının kontrolü sağlanmalıdır. Limiti üstünde bir tutar denerse karttan bakiye çekilir ancak cüzdana yüklemesi yapılmaz. Cüzdana yansımayan, askıda kalmış bakiyeler oluşur.

HTTP Method URL
POST /v1/Transaction/TopupCreditCard

İstek Parametreleri

Parametre Tip Zorunlu Açıklama
currency_code string Evet Para Birimi
account_number string Evet Hesap Numarası
credit_card_post_type_id string Hayır POS Tipinin ID Numarası
ext_transaction_id string Evet İşlem Id (Benzersiz Olmalı)
wallet_number string Evet Cüzdan Numarası
amount decimal Evet İşlem Tutarı
hash_key string Hayır Hash Anahtarı
source_type string Hayır Kaynak Tipi
channel_type string Hayır Kanal Tipi

Dönüş Parametreleri

Parametre Tip Açıklama
status int Statü
code string Kod
message string Mesaj
payload obje[] Veri
transaction_id string İşlem Id
ext_transaction_id string İşlem Id (Benzersiz Olmalı)
transaction_amount decimal İşlem Tutarı
transaction_fee_amount decimal İşlem Ücret Tutarı
previous_amount decimal Önceki Tutar
wallet_info obje Cüzdan Detay
id string Cüzdan ID
name string Adı
account_number string Kullanıcı Hesap Numarası
account_type string Kullanıcı Hesap Tipi
created_date_utc datetime Oluşturulma Tarihi
number string Kullanıcı Cüzdan Numarası
phone_country_code string Ülke Telefon Kodu
phone_number string Telefon Numarası
email string Mail Adresi
total_balance decimal Toplam Bakiye
monthly_incoming_total decimal Aylık Hesaba Gelen Bakiye
monthly_outgoing_total decimal Aylık Hesaptan Giden Bakiye
access_level_status_id int Hesap Durumu Id
access_level_status string Hesap Durumu (Aktif/Pasif)
payment_balance obje Ödeme Bakiyesi
available decimal Ödeme Bakiyesi /Kullanıma Uygun Bakiye
unavailable decimal Ödeme Bakiyesi / Kullanıma Uygun Olmayan Bakiye
cash_balance obje Nakit Bakiye
available decimal Nakit Bakiye /Kullanıma Uygun Bakiye
unavailable decimal Nakit Bakiye / Kullanıma Uygun Olmayan Bakiye
transaction_limits obje İşlem Limitleri
max_balance decimal Maksimum Bakiye
topup_credit_limit decimal Kredi Kartıyla Para Yükleme Limiti
topup_cash_limit decimal Nakit Yüklenebilecek Bakiye
withdrawal_limit decimal Çekim Limiti
payment_limit decimal Ödeme Limiti
wallet_to_wallet_limit decimal Cüzdanlar Arası Yapılabilecek Transfer Limiti
kyc_level_status string Kyc Level Statüsü
currency_code string Para Birimi
user_kyc_info string Kullanıcı KYC Bilgisi
is_topup_default bool Para Yükleme Default mu?
tax_number string Vergi Numarası
loyalty_record_required bool

İSTEK (POST) :

{
"ext_transaction_id" :"23132132ABC",
"credit_card_post_type_id" :"sipay_pos_123",
"amount": "100.00",
"currency_code": "TRY",
"account_number" : "565663432432",
"wallet_number": "4853534863917",
"hash_key" : " ",
"source_type" : "",
"channel_type": ""
}

YANIT:


    "status": 0,
    "code": "100",
    "message": "İşlem başarılı",
    "payload": {
        "transaction_id": "7045392751775050765",
        "ext_transaction_id": null,
        "transaction_amount": 1.0000,
        "transaction_fee_amount": 0.0,
        "previous_amount": 0.0,
        "wallet_info": {
            "id": "525119963898965005",
            "name": "",
            "account_number": "565663432432",
            "account_type": "Personal",
            "created_date_utc": "2021-10-20T12:06:49.5937505+00:00",
            "number": "276535231",
            "phone_country_code": null,
            "phone_number": null,
            "email": null,
            "total_balance": 9227.20,
            "monthly_incoming_total": 0.0,
            "monthly_outgoing_total": 0.0,
            "access_level_status_id": 1,
            "access_level_status": "Aktif",
            "payment_balance": {
                "available": 2.00,
                "unavailable": 0.00
            },
            "cash_balance": {
                "available": 9220.00,
                "unavailable": 5.20
            },
            "transaction_limits": {
                "max_balance": 200000.0000,
                "topup_credit_limit": 159849.6000,
                "topup_cash_limit": 159849.6000,
                "withdrawal_limit": 200000.0000,
                "payment_limit": 196993.9400,
                "wallet_to_wallet_limit": 197338.6150
            },
            "kyc_level_status": null,
            "currency_code": "TRY",
            "user_kyc_info": null,
            "is_topup_default": false,
            "tax_number": null,
            "loyalty_record_required": false
        }
    }
}