سرویس تبدیل شماره کارت به شبا

آدرس سرویس: POST https:/carbon/v4.0/bank_service/conversion_service/card_to_sheba

---

شرح

این سرویس جهت تبدیل شماره کارت مورد نظر به شماره شبا مورد استفاده قرار می گیرد .

---

Headers

مقادیر زیر باید در هدر قرار بگیرد

  Authorization : Basic ....
  clientAddress : ip client

توضیحات

• Authorization: در این قسمت توکن دریافت شده از سرویس توکن را وارد نمایید

• clientAddress: آی پی مشتری نهایی که سرویس را دریافت کرده است .

نمونه درخواست:

curl --location 'https:/carbon/v4.0/bank_service/conversion_service/card_to_sheba' \
--header 'Content-Type: application/json' \
--header 'accept: application/json' \
--header 'clientAddress: xxx' \
--header 'Authorization: ••••••' \
--data '{
    "request_number" : 202508162015,
    "card_number" : "...."
}'

جواب موفق:

{
    "status": "0",
    "message": "تراکنش با موفقیت انجام شد",
    "timestamp": "2025-12-10 10:33:53.193",
    "tracking_number": "859667469",
    "request_number": "202508162015",
    "result": {
        "card_number": "....",
        "card_type": "DEBIT",
        "bank_info": {
            "bank_name": "SAMAN",
            "deposit_number": "....",
            "iban": "....",
            "card_status": "ACTIVE"
        },
        "owner": [
            {
                "first_name": "....",
                "last_ame": "....",
                "count": 1
            }
        ]
    },
    "transaction_details": {
        "available_wallet_balance": "101938000",
        "provider_name": "Pertikan",
        "service_price": "....",
        "curency": "IRR",
        "remaining_number_of_calls": "1000",
        "remaining_number_of_calls_day": "1000"
    },
    "errors": {}
}

جواب ناموفق:

{
    "status": "1",
    "message": "تراکنش ناموفق",
    "timestamp": "2025-12-10 11:02:40.214",
    "tracking_number": "859668068",
    "request_number": "202508162015",
    "result": {},
    "transaction_details": {},
    "errors": {
        "error_code": "10173",
        "error_description": "Transaction failed : Provider  Error",
        "reference_name": "35_card.not_valid",
        "original_value": "کارت نامعتبر است"
    }
}

• status: عدد 0 به معنی موفق و عدد 1 به معنی ناموفق می باشد .
• message: پاسخ از طرف سرویس سامانه ابری کربن
• timestamp: زمان فراخوانی درخواست
• request number: شماره پیگیری ارسال شده در زمان فراخوانی
• tracking_number: شماره پیگیری ایجاد شده توسط سامانه ابری کربن جهت بررسی های بعدی
• result: آبجکتی از پاسخ سرویس شامل:
• card_number: شماره کارت
• card_type: مدل کارت
• bank_name: نام بانک مربوط به کارت
• deposite_number: شماره سپرده
• iban: شماره شبا
• card_status: وضعیت کارت ، فعال یا فعال نبودن
• first_name: نام
• last_name: نام خانوادگی

در صورت بروز خطا در درخواست :

• errors: جزییات خطا
• error_code: کد مربوط به خطایی که پیش آمده است
• error_description: متن خطا
• reference_name: اطلاعات تکمیلی خطا
• original_value: اطلاعات تکمیلی خطا