پرش به محتویات

شارژ مستقیم تک مرحله ای

آدرس سرویس: POST https:/carbon/v2.1/charge_service/topup

شرح

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

نکات بسیار مهّم :

1) شرط موفق بودن تراکنش دریافت کد 0 در فیلد Status و موجود بودن مقدار عددی صحیح در فیلد tracking_number و خالی بودن فیلد errors می‌باشد.

2) در صورتی که کد پاسخ دریافت شده در فیلد Status غیر 0 باشد و فیلد error_code داخل شی errors عدم قطعیت در خصوص وضعیت تراکنش را اعلام کند لازم است با استفاده از سرویس‌های استعلام وضعیت درخواست مقدار صحیح تراکنش استعلام گردد. مانند کد خطای 5000 و 3000 و ... (کدهای خطایی که نیازمند استعلام وضعیت تراکنش می‌باشند در جدول شماره 2 مشخص شده‌اند. «ستون فراخوانی سرویس استعلام»)

3) باید توجه داشته باشیم که در صورت هر پاسخی غیر از 0 در فیلد Status حتماً فیلد errors و فیلد error_code داخل آن دارای مقدار صحیح خواهد بود.

نمونه مقدار فیلد errors به شکل ذیل است:


"errors": {
    "error_code": "8002",
    "error_description": "Transaction failed : Provider Error",
    "reference_name": "Mobile no is inactive or not registered.",
    "original_value": "charge error"
}

لذا در صورت دریافت هرگونه پاسخ غیر از 0 در فیلد Status که مقدار فیلد errors شامل مقدار نباشد و یا فیلد error_code داخل شی errors مقدار نداشته باشد باید به عنوان پاسخ غیر قطعی در نظر گرفته شود و برای مشخص شدن وضعیت صحیح تراکنش می‌بایست سرویس استعلام وضعیت تراکنش فراخوانی گردد.

Headers

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

  Authorization : Bearer {Token}
  clientAddress : client IP

توجه : برای دریافت توکن مربوطه به بخش توکن مراجعه فرمایید

توضیحات

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

    Parameters

    • request_number(نوع داده عددی):(اجباری) این شناسه جهت پیگیری های بعدی مورد استفاده قرار می گیرد و پیشنهاد میگردد یه شناسه یکتا به ازای هر درخواست توسط سامانه مشتری تولید و به این سرویس ارسال گردد. سامانه ابری کربن هیچ کنترلی بر روی عدم تکراری بودن این مقدار انجام نمی دهد.

    • mobile (نوع داده عددی):(اجباری) شماره موبایل

    • merchant_name(نوع داده عددی):(اجباری) نام برند

    • card_number (نوع داده عددی):(اجباری) شماره کارت خرید کننده شارژ

    • channel_type (نوع داده عددی):(اجباری) نوع درگاه در جدول ذیل نمایش داده شده است

    • bank_id (نوع داده عددی):(اجباری) نوع بانک

    • national_code (نوع داده عددی):(اجباری) کد ملی خریدار

    • product_id (نوع داده عددی):(اجباری) کد محصول

    • amount (نوع داده عددی):(اجباری) مبلغ شارژ

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

    curl --location --request POST 'https:/carbon/v2.1/charge_service/topup' \
--header 'Authorization: Bearer ....' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mobile": "....",
    "merchant_name": "....",
    "card_number": "....",
    "channel_type": "....",
    "request_number": "....",
    "bank_id": "....",
    "national_code": "....",
    "product_id": "....",
    "amount":"...."
}

    لیست محصولات (کد محصول و مبلغ)

    کد محصول اپراتور نام سرویس مبلغ (ریال)
    58ایرانسلشارژ مستقیم 10000 ریالی۱۰,۰۰۰
    59ایرانسلشارژ مستقیم 20000 ریالی۲۰,۰۰۰
    60ایرانسلشارژ مستقیم 50000 ریالی۵۰,۰۰۰
    61ایرانسلشارژ مستقیم 100000 ریالی۱۰۰,۰۰۰
    62ایرانسلشارژ مستقیم 200000 ریالی۲۰۰,۰۰۰
    63 ایرانسل شارژ مستقیم (مبلغ دلخواه از 5,000 تا 1,000,000 ریال) مبلغ دلخواه
    64 ایرانسل شارژ شگفت انگیز (مبلغ دلخواه از 50,000 تا 200,000 ریال) مبلغ دلخواه
    65ایرانسلشارژ شگفت انگیز 50000 ریالی۵۰,۰۰۰
    66ایرانسلشارژ شگفت انگیز 100000 ریالی۱۰۰,۰۰۰
    67ایرانسلشارژ شگفت انگیز 200000 ریالی۲۰۰,۰۰۰
    68ایرانسلپرداخت قبض سیم کارت دائمیمبلغ دلخواه
    72همراه اولشارژ مستقیم 50000 ریالی۵۰,۰۰۰
    73همراه اولشارژ مستقیم 100000 ریالی۱۰۰,۰۰۰
    74همراه اولشارژ مستقیم 200000 ریالی۲۰۰,۰۰۰
    96همراه اولشارژ مستقیم 500000 ریالی۵۰۰,۰۰۰
    97همراه اولشارژ مستقیم ۱۰00000 ریالی۱,۰۰۰,۰۰۰
    75 همراه اول شارژ مستقيم (مبلغ دلخواه از 50,000 تا 1,000,000 ریال) مبلغ دلخواه
    76همراه اولپرداخت قبض سیم کارت دائمیمبلغ دلخواه
    98همراه اولشارژ جوانان 50000 ریالی۵۰,۰۰۰
    99همراه اولشارژ جوانان 100000 ریالی۱۰۰,۰۰۰
    100همراه اولشارژ جوانان 200000 ریالی۲۰۰,۰۰۰
    101همراه اولشارژ جوانان 500000 ریالی۵۰۰,۰۰۰
    102همراه اولشارژ جوانان ۱۰00000 ریالی۱,۰۰۰,۰۰۰
    103همراه اولشارژ بانوان 50000 ریالی۵۰,۰۰۰
    104همراه اولشارژ بانوان 100000 ریالی۱۰۰,۰۰۰
    105همراه اولشارژ بانوان 200000 ریالی۲۰۰,۰۰۰
    106همراه اولشارژ وفاداری 100000 ریالی۱۰۰,۰۰۰
    107همراه اولشارژ وفاداری 200000 ریالی۲۰۰,۰۰۰
    108همراه اولشارژ وفاداری 500000 ریالی۵۰۰,۰۰۰
    109همراه اولشارژ وفاداری ۱۰00000 ریالی۱,۰۰۰,۰۰۰
    82رایتلشارژ مستقیم 20000 ریالی۲۰,۰۰۰
    83رایتلشارژ مستقیم 50000 ریالی۵۰,۰۰۰
    84رایتلشارژ مستقیم 100000 ریالی۱۰۰,۰۰۰
    85رایتلشارژ مستقیم 200000 ریالی۲۰۰,۰۰۰
    86رایتلشارژ مستقیم 500000 ریالی۵۰۰,۰۰۰
    87 رایتل شارژ مستقیم رایتل (مبلغ دلخواه از 50,000 تا 1,000,000 ریال) مبلغ دلخواه
    88رایتلشارژ مستقیم شورانگیز 50000 ریالی۵۰,۰۰۰
    89رایتلشارژ مستقیم شورانگیز 100000 ریالی۱۰۰,۰۰۰
    90رایتلشارژ مستقیم شورانگیز 200000 ریالی۲۰۰,۰۰۰
    91رایتلشارژ مستقیم شورانگیز 500000 ریالی۵۰۰,۰۰۰
    92 رایتل شارژ شورانگیز رایتل (مبلغ دلخواه از 50,000 تا 1,000,000 ریال) مبلغ دلخواه
    93رایتلپرداخت قبض سیم کارت دائمی رایتلمبلغ دلخواه
    114تالیاشارژ مستقیم تالیامبلغ دلخواه

    لیست درگاه ها

    کد نوع درگاه
    02ATM
    03Branch
    07Telephone Bank / IVR
    13Info Kiosk
    14POS
    59Internet
    05Mobile Application
    06USSD

    لیست بانک ها

    نام بانک کد بانک نام بانک کد بانک
    بانک ملی۱۷ بانک ملت۱۲
    بانک پاسارگاد۵۷ بانک سامان۵۶
    بانک سپه۱۵ بانک کشاورزی۱۶
    بانک رسالت۷۰ بانک تجارت۱۸
    بانک صادرات۱۹ بانک اقتصاد نوین۵۵
    بانک رفاه۱۳ بانک مسکن۱۴
    بانک آینده۶۲ بانک دی۶۶
    بانک سینا۵۹ بانک پارسیان۵۴
    بانک کارآفرین۵۳ موسسه اعتباری ملل۷۵
    بانک ایران زمین۶۹ بانک صنعت و معدن۱۱
    بانک سرمایه۵۸ بانک توسعه صادرات۲۰
    بانک شهر۶۱ موسسه اعتباری نور۸۰
    بانک خاورمیانه۷۸ موسسه اعتباری توسعه۵۱
    بانک پست ایران۲۱ بانک قرض الحسنه مهر ایران۶۰
    بانک ایران ونزوئلا۹۵ بانک گردشگری۶۴
    سایر۹۹ کیف پول۱

    جواب موفق: 

    {
    "status": "0",
    "message": "تراکنش با موفقیت انجام شد",
    "timestamp": "2023-01-07 01:41:42.499",
    "tracking_number": "122154845",
    "request_number": "1215411545",
    "result": {
        "reference_number": "...."
    },
    "transaction_details": {
        "available_wallet_balance": "979958638",
        "provider_name": "smart carbon",
        "service_price": "....",
        "curency": "IRR",
        "remaining_number_of_calls": "9908",
        "remaining_number_of_calls_day": "9908"
    },
    "errors": {}
}

    جواب ناموفق: 

    {
    "status": "1",
    "message": "تراکنش ناموفق",
    "timestamp": "2023-01-07 01:58:11.24",
    "tracking_number": "1343333",
    ”request_number”: "12148121841",
    "result": {},
    "transaction_details": {},
    "errors": {
        "error_code": "8002",
        "error_description": "Transaction failed : Provider  Error",
        "reference_name": "Mobile no is inactive or not registered.",
        "original_value": "charge error"
    }
}
    • status: عدد 0 به معنی موفق و عدد 1 به معنی ناموفق می باشد
    • message: پاسخ از طرف سرویس سامانه ابری کربن
    • timestamp: زمان و تاریخ درخواست
    • request_number: شماره پیگیری ارسال شده در زمان فراخوانی
    • tracking_number: شماره پیگیری ایجاد شده توسط سامانه ابری کربن جهت بررسی های بعدی
    • result: آبجکتی از پاسخ سرویس شامل:
    • reference_number: شماره مرجع
    • service_price: قیمت سرویس

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

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