Skip to content

Create IBAN withdrawal

Create a withdrawal using IBAN

Endpoint for withdrawal creation

Withdrawal operation

POST /api/ibancredit

This endpoint expects POST request in JSON format with parameters.

Request and response parameters

Request parameters

Parameters                        Type Mandatory Description
version string(10) optional Protocol version.
Default value: 1.0.1
Version 1.0 is deprecated
order_id string(1024) mandatory Order ID which is generated by merchant
merchant_id integer(12) mandatory Merchant unique ID. Generated by Flitt during merchant registration
order_desc string(1024) mandatory Order description. Generated by merchant in UTF-8 always
amount integer(12) mandatory Order amount without separator. 1020 (GEL) means 10 lari and 20 tetri
currency string(3) mandatory Order currency. Only GEL is supported for IBAN withdrawal
server_callback_url string(2048) optional Merchant site URL, where host-to-host callback will be sent after payment completion. See Callbacks for more details on callbacks.
signature string(40) mandatory Order signature. Required to verify merchant request consistency and authenticity. Signature generation algorithm please see at Signature generation for request and response and response
merchant_data string(2048) optional Any arbitrary set of data that a merchant wants to get back in the response to and server_callback_url, and also in reports
product_id string(1024) optional Merchant product or service id
receiver_iban string(40) mandatory IBAN number
receiver_name string(200) optional Receiver name
settlement_description string(1024) optional Receiver name
merchant_data string(2048) optional Any arbitrary set of data that a merchant wants to get back in the response to response_url or/and server_callback_url, and also in reports
reservation_data string(10000) optional BASE64 encoded JSON data, refer to Additional Data details page

see response parameters

Request examples

{
  "request": {
    "order_id": "test_1234312142",
    "merchant_id": "1549901",
    "order_desc": "Test order",
    "amount": 1000,
    "currency": "GEL",
    "receiver_iban": "GE71TB0000000111111111",
    "server_callback_url": "https://myserver.com/callback",
    "signature": "51e59ffd263d071da8e1a1fc10b981f459dbe6f1"
  }
}

Response examples

{
  "response": {
    "product_id": "",
    "masked_card": "",
    "currency": "GEL",
    "response_description": "",
    "order_status": "approved",
    "response_status": "success",
    "order_time": "21.09.2024 01:22:02",
    "order_id": "test_1234312142",
    "tran_type": "p2p credit",
    "payment_system": "iban",
    "approval_code": "",
    "merchant_id": 1549901,
    "payment_id": 818990350,
    "card_bin": null,
    "response_code": "",
    "card_type": "",
    "amount": "1000",
    "signature": "e7e8b3641dab8eee546e8183b9180e67f1568deb",
    "additional_info": "{\"capture_status\": null, \"capture_amount\": null, \"reservation_data\": null, \"transaction_id\": 2019043606, \"bank_response_code\": null, \"bank_response_description\": null, \"client_fee\": 0.0, \"settlement_fee\": 0.0, \"bank_name\": null, \"bank_country\": null, \"card_type\": \"\", \"card_product\": \"\", \"card_category\": null, \"timeend\": \"21.09.2024 01:22:03\", \"ipaddress_v4\": \"178.54.60.26\", \"payment_method\": \"TBC\", \"payer_iban\": \"GE71TB0000000111111111\", \"is_test\": true}"
  }
}

{
  "response": {
    "error_code": 1002,
    "error_message": "Application error",
    "request_id": "ghfIuTtVrbWYY",
    "response_status": "failure"
  }
}