حسابداری نمو راهنمای توسعه‌دهندگان

پرداخت و برگشت

پرداختی که بعد از سفارش رسید (پرداخت در محل، کارت‌به‌کارت) و سفارشی که کامل برگشت خورد.

هر دو مسیر سفارش را با external_id در نشانی و source (در query یا بدنه) پیدا می‌کنند. اگر source نفرستید، api در نظر گرفته می‌شود. دسترسی لازم: orders.write.

ثبت پرداخت

POST/api/v1/orders/{external_id}/payment/

برای سفارشی که بدون payment فرستاده شده بود و حالا پولش رسید — پیک پرداخت در محل را تحویل داد، یا مشتری کارت‌به‌کارت کرد.

curl https://panel.nemosystem.ir/api/v1/orders/10452/payment/ \
  -H "Authorization: Bearer $NEMO_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "source": "site:shop.example.com", "method": "cash", "reference": "", "date": "2026-10-03" }'

فیلدها همان فیلدهای payment در ثبت سفارشاند (method، reference، date). می‌توانید آن‌ها را مستقیم در بدنه یا داخل یک شیء payment بفرستید.

پاسخ 200 وضعیت تازهٔ سفارش است — همان شکل پاسخ ثبت سفارش، معمولاً با "status": "paid" و receipt_number.

برگشت سفارش

POST/api/v1/orders/{external_id}/refund/

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

curl https://panel.nemosystem.ir/api/v1/orders/10452/refund/ \
  -H "Authorization: Bearer $NEMO_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "source": "site:shop.example.com", "reason": "انصراف مشتری" }'
فیلدتوضیح
reasonاختیاری؛ در شرح برگشت از فروش می‌نشیند.

پاسخ 200 با "status": "refunded" و return_number.