We are using cookies in our website in order to offer better service to you. You allow us to use cookies by continuing to use our internet website. You can reach the detailed information on cookies from our Privacy Policy and Cookies Policy.
X
Home > Api Products > Money Transfer FAST API

Money Transfer FAST API

Description

​Money Transfer FAST API makes FAST transfer for corporate/individual account holders.

FAST Validations

FAST Validations API validates FAST request for the given parameters.

Sample Request

POST /api/isbank/v1/fast-validations

Headers:

X-IBM-client-id: {YOUR_CLEINT_ID} 
X-IBM-client-secret: {YOUR_CLEINT_SECRET} 
Authorization: Bearer {access_token}
Accept: application/json
{
    "amount": 121.8, // Tutar
    "currency": "TRY", // Kur
    "debtor_account_id": "152605", // Seçilen müşteri hesap id'si
    "debtor_use_of_overdraft": false, // Ek hesap kullanımı
    "creditor_name": "Creditor Name", // Alıcı adı
    "creditor_iban": "TR310006200001500001231212", // Alacaklı iban
    "description": "Fast Açıklama", // İşlem açıklaması
    "payment_reference_id": "4895-cvert-234", // Karşı kurum unique id'si
    "customer_ip": "123.234.233.23", // Müşteri ip'si
    "issuing_party": { // Amir Bilgisi
        "name": "Amir Ad", // Amir Ad
        "party_Address": "Amir Adres", // Amir Adres
        "legal_id": "123456", // Amir Legal id
        "pisp_account_number": 2, // Amir Hesap Numarası
        "country_city": "34", // Amir Ülke Şehir
        "customer_Number": "323", // Amir Müşteri Numarası
        "place_of_birth": "Amir Doğum Yeri" // Amir Doğum Yeri
    }

FAST Payments

FAST Payments API executes FAST request for the given parameters.

Sample Request

POST /api/isbank/v1/fast-payments

Headers:

X-IBM-client-id: {YOUR_CLEINT_ID} 
X-IBM-client-secret: {YOUR_CLEINT_SECRET} 
Authorization: Bearer {access_token}
Accept: application/json
{
    "amount": 121.8, // Tutar
    "debtor_account_id": "152605", // Seçilen müşteri hesap id'si
    "debtor_use_of_overdraft": false, // Ek hesap kullanımı
    "creditor_name": "Creditor Name", // Alıcı adı
    "creditor_iban": "TR310006200001500001231212", // Alacaklı iban
    "description": "Fast Açıklama", // İşlem açıklaması
    "payment_reference_id": "4895-cvert-234", // Karşı kurum unique id'si
    "query_number": "H18000204312", // İşlem sorgu numarası
    "customer_ip": "123.234.233.23", // Müşteri ip'si
    "idempotency_key": "c2b66121-2c94-1281-12e1-1232361f22d2", // Her işleme özel key(guid),
    "issuing_party": { // Amir Bilgisi
        "name": "Amir Ad", // Amir Ad
        "party_Address": "Amir Adres", // Amir Adres
        "legal_id": "123456", // Amir Legal id
        "pisp_account_number": 2, // Amir Hesap Numarası
        "country_city": "34", // Amir Ülke Şehir
        "customer_Number": "323", // Amir Müşteri Numarası
        "place_of_birth": "Amir Doğum Yeri" // Amir Doğum Yeri
    }
}

FAST Query

FAST Payments Query API retrieves FAST detail for the given query number and date.

Parameters


query-number : String
date : String(YYYY-MM-DD)

Sample Request

GET /api/v1/fast-payments/REPLACE_QUERY-NUMBER?date=REPLACE_THIS_VALUE

Headers:

X-IBM-client-id: {YOUR_CLEINT_ID} 
X-IBM-client-secret: {YOUR_CLEINT_SECRET} 
Accept: application/json




Sample Response

​​​

Sample Response - FAST Validations

{
    "data": {
        "result": true, // Validasyon sonucu
        "amount": 121.8,
        "fee_amount": 2.1, // Masraf tutarı
        "fee_tax_amount": 0.11, // Masraf vergi tutarı
        "debtor_account_name": "ANNELID BUTAIN", // Borçlu hesap adı
        "creditor_account_name": "Creditor Name", // Alacaklı hesap adı
        "source_account_amount": 124.01, // Hesaptan kullanılan tutar
        "overdraft_amount": 0, // Ek hesaptan kullanılan tutar
        "fund_801_amount": 0, // 801 numaralı fondan kullanılan tutar
        "fund_808_amount": 0, // 808 numaralı fondan kullanılan tutar
        "fund_818_amount": 0, // 818 numaralı fondan kullanılan tutar
        "fund_total_amount": 0, // Fondan kullanılan toplam tutar
        "maximum_term_account_amount": 0, // Maksimum vadeli hesaptan kullanılan tutar
        "invesment_account_amount": 0, // Yatırım hesabından kullanılan tutar
        "invesment_total_amount": 0, // Yatırım hesaplarından kullanılan toplam tutar
        "payment_reference_id": "4895-cvert-234"
    }


Sample Response - FAST Payments

{
    "data": {
        "amount": 121.8,
        "fee_amount": 2.1,
        "fee_tax_amount": 0.11,
        "debtor_account_name": "ANNELID BUTAIN",
        "creditor_account_name": "Creditor Name",
        "source_account_amount": 124.01,
        "overdraft_amount": 0,
        "fund_801_amount": 0,
        "fund_808_amount": 0,
        "fund_818_amount": 0,
        "fund_total_amount": 0,
        "maximum_term_account_amount": 0,
        "invesment_account_amount": 0,
        "invesment_total_amount": 0,
        "query_number": "H18000204312", // İşlem sorgu numarası
        "payment_reference_id": "4895-cvert-234",
        "created_at": "2018-03-07T12:40:14.3779636+03:00", // Ödeme yaratılma zamanı
        "state": "APPROVED", // Ödeme durumu
        "executed_at": "2018-03-07T12:40:16.04213+03:00" // Ödeme gerçekleştirme zamanı
    }


Sample Response - FAST Query

{
    "data": {
        "amount": 121.8,
        "debtor_account_name": "ANNELID BUTAIN",
        "creditor_account_name": "Creditor Name",
        "query_number": "0915831",
        "state": "APPROVED"
    }
}