انتقال پل

آدرس سرویس: POST https:/carbon/v4.0/bank_service/account/pol_transfer

---

شرح

این سرویس جهت انتقال از طریق پل مورد استفاده قرار می گیرد.

---

Headers

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

  Authorization : Bearer {Token}
  clientAddress : client IP

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

توضیحات

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

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

Parameters

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

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

• amount (نوع داده عددی):(اجباری) مقدار وجه جهت انتقال

• source_deposit_number (نوع داده عددی):(اجباری) شماره حساب مبدا

• destination_iban (نوع داده عددی):(اجباری) شماره شبا مقصد

• destination_iban_owner (نوع داده رشته):(اجباری) صاحب شماره شبا مقصد

• reason_code (نوع داده رشته):(اجباری) کد مربوطه (در جدول زیر توضیح داده شده است)

• source_description (نوع داده رشته):(اجباری) توضیحات مبدا

• destination_description (نوع داده رشته):(اجباری) توضیحات مقصد

• payment_id (نوع داده عددی):(اجباری) شناسه پرداخت

مقادیر کد مربوطه جهت انقتال (reason_code):

Active	Documentations	LatinDescription	Description	Code
true	یک طرف تراکنش حساب شرکت بیمه معتبر فعال است	insurance services	امور بیمه خدمات	IOSP
true	اسناد درمانی ارائه شود	health care services	امور درمانی	HIPA
true	یک طرف حساب نهاد های مالی مجاز باشد	invesment and stock marketing	امور سرمایه گذاری و بورس	ISAP
true	مستندات مربوط به موضوع ارزی	criteria based currency services	امور ارزی در چارچون ضوابط و مقررات	FXAP
true	به شرح فرم پیوست	debt payment	پرداخت قرض و تادیه دیون	DRPA
true	طرف حساب صندوق بازنشستگی(فهرست مطابق با جمع مبلغ)	retirement services	امور بازنشستگی	RTAP
true	حداقل مبایعه نامه ارائه شود(بجز خودرو بقیه موارد چک شود)	registered property trading	معاملات اموال منقول	MPTP
true	حداقل مبایعه نامه ارائه شود	unregistered Property trading	معاملات اموال غیرمنقول	IMPT
true	جابجایی بین حساب های مشتری(درون یا بین بانکی)	liquidity management	مدیریت نقدینگی	LMAP
true	اسناد مرتبط با گمرک	customs	عوارض گمرکی	CDAP
true	طرف حساب اداره مالیاتی است + اظهارنامه مالیاتی	tax balance	تسویه مالیاتی	TCAP
true	مستندات مربوط	other govermental services	سایر خدمات دولتی	GEAC
true	اسناد مرتبط بانکی	loans and Obligations	تسهیلات و تعهدات	LRPA
true	یک طرف تراکنش ، حساب بانک است	bail	تودیع وثیقه	CCPA
true	قبوض مرتبط ارائه شود	daily costs	هزینه عمومی و امور روزمره	GPAC
true	یک طرف تراکنش حساب موسسه خیریه ثبت شده رسمی می باشد	charity	کمک های خیریه	CPAC
true	پیش فاکتور خرید کالا یا تصویر قرارداد	utility Purchase	خرید کالا	GPPC
true	پیش فاکتور خرید خدمت یا تصویر قرارداد	services purchase	خرید خدمات	SPAC
true	ارائه لیست بیمه + لیست حقوق(همپوشانی داشته باشد)	income deposit	واریز حقوق	POSA

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

curl --location --request POST 'https:/carbon/v4.0/bank_service/account/pol_transfer' \
--header 'Authorization:Bearer ....' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bank_name": "sepah",
    "request_number": 202508162015,
    "amount": ....,
    "source_deposit_number": "....",
    "destination_iban": "....",
    "destination_iban_owner": "....",
    "reason_code": "....",
    "source_description": "....",
    "destination_description": "....",
    "payment_id": "...."
}

جواب موفق:

{
    "status": "0",
    "message": "تراکنش با موفقیت انجام شد",
    "timestamp": "2026-01-12 09:53:28.298",
    "tracking_number": "336",
    "request_number": "202508162015",
    "result": {
        "amount": "....",
        "rrn": "....",
        "source_deposit_number": "....",
        "source_bank_name": "....",
        "destination_iban": "....",
        "destination_iban_owner": "....",
        "destination_bank_name": ".... ",
        "currency": "IRR",
        "commission": "...."
    },
    "transaction_details": {
        "available_wallet_balance": "200000000",
        "provider_name": "Pertikan",
        "service_price": "....",
        "curency": "IRR",
        "remaining_number_of_calls": "911",
        "remaining_number_of_calls_day": "911"
    },
    "errors": {}
}

جواب ناموفق:

{
    "status": "1",
    "message": "تراکنش ناموفق",
    "timestamp": "2026-01-12 09:51:57.313",
    "tracking_number": "330",
    "request_number": "202508162015",
    "result": {},
    "transaction_details": {},
    "errors": {
        "error_code": "10002",
        "error_description": "Transaction failed : Provider  Error",
        "reference_name": "49_",
        "original_value": ""
    }
}

• status: عدد 0 به معنی موفق و عدد 1 به معنی ناموفق می باشد
• message: پاسخ از طرف سرویس سامانه ابری کربن
• timestamp : زمان و تاریخ درخواست
• request_number: شماره پیگیری ارسال شده در زمان فراخوانی
• tracking_number: شماره پیگیری ایجاد شده توسط سامانه ابری کربن جهت بررسی های بعدی
• result: آبجکتی از پاسخ سرویس شامل:
• amount : مقدار وجه
• rrn : شماره مرجع
• source_deposit_number: شماره حساب مبدا
• source_bank_name: نام بانک مبدا
• destination_iban: شماره شبا مقصد
• destination_iban_owner: صاحب شماره شبا مقصد
• destination_bank_name: نام بانک مقصد
• currency: واحد پول
• commission: کمیسیون

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

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

---