NAV
shell python

مستند سرویسpdp

در این مستند به معرفی سرویس pdp معرفی شده است که فروشگاه ها میتوانند بعد از عقد قرارداد با بالون از طریق این درگاه اقدام به اعطای تسهیلات به کاربران خود کنند.

احراز هویت

دریافت توکن

import requests

data = {
    'username': 'store name',
    'password': 'store password'
}

response = requests.post('https://api.baloan.ir/api/v1/merchant/token/', data=data)

curl -X POST -d username=store_name -d password=store_password \
   https://api.baloan.ir/api/v1/merchant/token/

Successful response:

{
  "refresh": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0bmVzaCIsImV42ODM5MDU5MSwiaWF0IjoxNjY4M",
  "access": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.6Xg5lfYhy5DqJbHNT2XZ_crZrv8QmXyrNqN4RG-Q-pU"
}

فروشگاه برای ورود به درگاه اعتباری بالون باید از username و password دریافت شده بعد از عقد قرارداد استفاده کنند.

احراز هویت

# With shell, you can just pass the correct header with each request
curl "api_endpoint_here" \
  -H "Authorization: Bearer {accesstoken}"

response = requests.post('your_endpoint', headers={'Authorization': f'Bearer {accesstoken}'})

You must replace accesstoken with your access key in token request.

برای تمام درخواستهای بعدی باید این مقدار در هدر درخواست ست شده باشد:

Authorization: Bearer accesstoken

سرویس محاسبه اقساط وام

با ارسال مقدار وام بر اساس سیاست های وام دهی که برای فروشگاه تعریف شده مبلغ قسط بر اساس مدت بازپرداخت آن برمیگردد

curl --location 'http://api.baloan.ir/api/v1/merchant/loan-plan/?amount=100000' \
--header 'Authorization: Bearer {accesstoken}' \

import requests

url = "http://api.baloan.ir/api/v1/merchant/loan-plan/"

params = {"amount": 1000000}
headers = {
  'Authorization': 'Bearer {accesstoken}'
}

response = requests.request("GET", url, headers=headers, params=params)

The above command returns JSON structured like this:

You must replace accesstoken with your access key in token request.

{
  "12": {
    "monthly_installment": 93595,
    "link": "https:///app.baloan.ir/?store=12&amount=100000&loan_due=12&referral_code=123456"
  }
}

خطاها

درگاه اعتباری بالون به صورت کلی شامل ارور های زیر است:

Error Code Meaning
400 Bad Request -- Your request is invalid.
401 Unauthorized -- Your API key is wrong.
404 Not Found -- The specified api could not be found.
429 Too Many Requests -- You're requesting too many! Slow down!
503 Service Unavailable -- We're temporarily offline for maintenance. Please try again later.
shell python