Make Payment

URL

The relevant endpoint and http method information used to pay bills are given below.

HTTP Method URL
POST /v1​/InvoicePayment​/MakePayment

Request Params

Params Type Mandatory Description
account_type_id integer Yes Account Type Id (1:Individual , 2:Business)
account_number string Yes Account Number
wallet_number string Yes Wallet Number
inv_payment_transaction_query_oid string Yes Invoice Transaction Id (Comes from GetInvoicesByProductAndSubscriber Service)
invoice_amount decimal Yes Invoice Amount (Income from GetInvoicesByProductAndSubscriber Service)
payment_amount decimal Yes Payment Amount (Income from GetInvoicesByProductAndSubscriber Service)
product_oid string Yes Institution Id (Comes from GetInvoicesByProductAndSubscriber Service)
subscriber_no string Yes It varies according to the invoice type (Ex: GSM , Contract Number , TCKN) Income from GetInvoicesByProductAndSubscriber Service
bill_term string Yes Invoice Date (Revenue from GetInvoicesByProductAndSubscriber Service)
bill_no string Yes Invoice Number (Comes from GetInvoicesByProductAndSubscriber Service)

Response Params

Params Type
status integer
code string
message string
payload object
invoice_type string
inv_payment_transaction_query_oid string
receipt_output_print string
institution_name string
payment_transaction_id string
transaction_id string
transaction_amount decimal
transaction_fee decimal
charged_amount decimal
ext_order_id string
business_code string
business_name string
friendly_name string
receiver_account_number string
receiver_wallet_number string
sender_wallet_info object
id string
tenant_id string
name string
account_number string
account_type string
created_date_utc string
number string
phone_country_code string
phone_number string
email string
total_balance decimal
monthly_incoming_total decimal
monthly_outgoing_total decimal
access_level_status_id int
access_level_status string
payment_balance object
available decimal
unavailable decimal
cash_balance object
available decimal
unavailable decimal
transaction_limits object
max_balance decimal
topup_credit_limit decimal
topup_cash_limit decimal
withdrawal_limit decimal
payment_limit decimal
wallet_to_wallet_limit decimal
kyc_level_status string
currency_code string
user_kyc_info string
is_topup_default boolean
tax_number string
loyalty_record_required boolean

REQUEST (POST):

{
  "tenant_id": 0,
  "account_type_id": 1,
  "account_number": "28XX01",
  "wallet_number": "25XX25",
  "inv_payment_transaction_query_oid": "90XX46-FXX5-4XX3-8DXX-B1XX97",
  "invoice_amount": 196.50, 
  "payment_amount": 196.50, 
  "product_oid": "8064fb0c-c556-4104-8fe4-9779c6dc3721",
  "subscriber_no": "5536557580",
  "bill_term": "03/2023",
  "bill_no": "2023XXX887"
}

RESPONSE:

{
    "status": 0,
    "code": "100",
    "message": "İşlem başarılı",
    "payload": {
        "invoice_type": null,
        "inv_payment_transaction_query_oid": "90XX46-FXX5-4XX3-8DXX-B1XX97",
        "receipt_output_print": "termal",
        "institution_name": "Türk Telekom (Mobil)",
        "payment_transaction_id": "9623XX2189",
        "transaction_id": "ABRVXXX7304",
        "transaction_amount": 196.5000,
        "transaction_fee": 0.000000,
        "charged_amount": 196.500000,
        "ext_order_id": "90XX46-FXX5-4XX3-8DXX-B1XX97",
        "business_code": "",
        "business_name": "",
        "friendly_name": "",
        "receiver_account_number": "412XX50",
        "receiver_wallet_number": "126XX30",
        "sender_wallet_info": {
            "id": "45X9XX21",
            "tenant_id": "5",
            "name": "",
            "account_number": "28XX01",
            "account_type": "Personal",
            "created_date_utc": "2022-01-18T07:48:51.7092961+00:00",
            "number": "25XX25",
            "phone_country_code": null,
            "phone_number": null,
            "email": null,
            "total_balance": 899.47,
            "monthly_incoming_total": 0.0,
            "monthly_outgoing_total": 0.0,
            "access_level_status_id": 1,
            "access_level_status": "Aktif",
            "payment_balance": {
                "available": 0.0,
                "unavailable": 0.00
            },
            "cash_balance": {
                "available": 899.47,
                "unavailable": 0.00
            },
            "transaction_limits": {
                "max_balance": 1000000.0000,
                "topup_credit_limit": 996004.0060,
                "topup_cash_limit": 996004.0060,
                "withdrawal_limit": 1000000.0000,
                "payment_limit": 997238.4300,
                "wallet_to_wallet_limit": 999699.8000
            },
            "kyc_level_status": null,
            "currency_code": "TRY",
            "user_kyc_info": null,
            "is_topup_default": false,
            "tax_number": null,
            "loyalty_record_required": false
        }
    }
}