NUMU Docs
Contact
API
ThemesPartner Apps
API
ThemesPartner Apps
  1. Orders & fulfillment
  • 🗂️ Overview
  • 🚀 Quickstart
  • Authentication
  • Webhooks
  • Errors
  • Pagination
  • Rate limits
  • API terms
  • Versioning
  • Changelog
  • Merchant APIs
    • Identity
      • Get current user
      • Identify the calling personal access token
    • Catalog
      • Create new product
      • List products
      • Get product by ID
      • Update product
      • Delete product
      • Upload product image
      • Delete product image
      • Set product image alt text
      • Download CSV import template
      • Import products from CSV
      • Export products as CSV
      • List variants for a product
      • Create a variant
      • Update a variant
      • Delete a variant
      • List gift cards
      • Issue a new gift card
      • Get gift card
      • List gift card transactions
      • Void a gift card (zero remaining balance)
      • Get inventory list
      • Get inventory statistics
      • Adjust stock level
      • Bulk adjust stock levels
      • List all inventory levels for a store
      • List inventory levels for a variant
      • List inventory levels at a location
      • Set inventory level at a location
      • List inventory transfers
      • Create a draft transfer
      • Get transfer
      • Replace lines (DRAFT only)
      • Move transfer through its state machine
      • Create new category
      • List categories
      • Get category by ID
      • Update category
      • Delete category
      • Upload category image
      • Create upsell rule
      • List upsell rules
      • Get upsell rule
      • Update upsell rule
      • Delete upsell rule
      • Create product bundle
      • List bundles for a store or product
      • Set bundles for a product (replace all)
      • Get bundle details
      • Update bundle
      • Delete bundle
      • Reorder bundles
    • Orders & fulfillment
      • List payment proofs for an order
        GET
      • List manual-payment orders awaiting merchant review
        GET
      • Create new order
        POST
      • List orders
        GET
      • Create a draft order
        POST
      • Convert draft order to a real order
        POST
      • List COD Autopilot exception orders
        GET
      • Resolve (dismiss) a COD Autopilot exception
        POST
      • Per-status order counts (list tab badges)
        GET
      • Update order
        PATCH
      • Cancel order
        DELETE
      • Update order status
        PATCH
      • Mark order as paid
        POST
      • Undo a manual mark-paid (payment back to pending)
        POST
      • Customer kept part of the order at the door
        POST
      • Get order timeline
        GET
      • List order activity stream (staff comments + system events)
        GET
      • Add a staff comment to an order
        POST
      • Bulk update order statuses
        POST
      • Resend order status email
        POST
      • Preview order status email
        GET
      • WhatsApp sends for an order
        GET
      • Resend the WhatsApp order confirmation
        POST
      • Abandoned vs recovered carts — counts, value, payback
        GET
      • List abandoned checkouts for a store
        GET
      • Get an abandoned checkout
        GET
      • Send a recovery email to the abandoned-checkout's customer
        POST
      • Manually mark an abandoned checkout as recovered
        POST
      • Turn an abandoned checkout into a real COD order
        POST
      • Send a WhatsApp abandoned-cart recovery nudge
        POST
      • Preview a CSV order import (parses headers + suggests mapping)
        POST
      • Execute a CSV order import with a confirmed mapping
        POST
      • List the target fields the importer understands
        GET
      • Send the order's payment link into a linked conversation
        POST
      • Request a refund for an order
        POST
      • List refunds for an order
        GET
      • Get refund details
        GET
      • Approve a refund request
        POST
      • Reject a refund request
        POST
      • Process a refund through payment provider
        POST
      • List all refunds for a store
        GET
      • List returns for the store
        GET
      • Get one return
        GET
      • Approve a pending return
        POST
      • Reject a return
        POST
      • Mark a return as physically received
        POST
      • Issue refund for a received return
        POST
      • Carrier catalog with this store's connection state
        GET
      • Save credentials for a carrier
        PUT
      • Disconnect a carrier
        DELETE
      • Verify a carrier's stored credentials
        POST
      • Change a connected carrier's settings
        PATCH
      • Known Egyptian couriers to start from
        GET
      • This store's courier profiles
        GET
      • Add a courier
        POST
      • Update a courier
        PATCH
      • Remove a courier
        DELETE
      • Print waybills for a batch of shipments
        POST
      • Print one waybill
        GET
      • Export the pickup manifest as CSV
        GET
      • Preview a courier's status sheet
        POST
      • Apply reviewed status rows
        POST
      • Create shipment
        POST
      • List shipments
        GET
      • Bulk create shipments
        POST
      • Shipment dashboard stats
        GET
      • COD reconciliation summary
        GET
      • List pickups
        GET
      • Schedule a pickup
        POST
      • Get shipment detail
        GET
      • Update shipment on Bosta
        PATCH
      • Cancel shipment
        POST
      • Request return shipment
        POST
      • Track shipment
        GET
      • Print AWB (Air Waybill)
        GET
      • Get delivery details from Bosta
        GET
      • Get business pickup locations
        GET
      • Get pickup details
        GET
      • Update pickup
        PATCH
      • Cancel pickup
        DELETE
      • Get Bosta cities
        GET
      • Get zones in a city
        GET
      • Record an out-of-band payment against an order
        POST
      • Get order by ID or order number
        GET
    • Settings & money
      • Stream a payment proof image (merchant-authenticated)
      • Approve a customer-submitted proof
      • Reject a customer-submitted proof
      • Find perceptually similar prior proofs in this store
      • Create new invoice
      • List store invoices
      • Get invoice details
      • Update draft invoice
      • Delete draft invoice
      • Submit invoice to ETA
      • Download invoice PDF
      • Get (or create) the invoice for an order
      • List locations
      • Create location
      • Get location
      • Update location
      • Delete location
      • Get all store settings
      • Get payment settings
      • Update payment settings
      • Get COD trust network protection settings
      • Update COD trust network protection settings
      • Get COD Autopilot settings
      • Update COD Autopilot settings
      • Get storefront password-protection status
      • Enable/disable storefront password & set the password
      • Get the store's custom product-label definitions
      • Replace the store's custom product-label definitions
      • Save Paymob credentials
      • Get Paymob credentials status
      • Remove Paymob credentials
      • Save Kashier credentials
      • Get Kashier credentials status
      • Remove Kashier credentials
      • Save Fawaterak credentials
      • Get Fawaterak credentials status
      • Remove Fawaterak credentials
      • Save Moyasar credentials
      • Get Moyasar credentials status
      • Remove Moyasar credentials
      • Get shipping settings
      • Update shipping settings
      • Add shipping zone
      • Update shipping zone
      • Delete shipping zone
      • Save Bosta credentials
      • Get Bosta credentials status
      • Remove Bosta credentials
      • Get invoice/tax settings
      • Update invoice/tax settings
      • Get WhatsApp settings
      • Update WhatsApp settings
      • Get storefront customization settings
      • Update storefront customization (save draft)
      • Publish storefront customization to live store
      • Reset storefront customization to theme defaults
      • Upload a customization asset (logo, favicon, hero image)
      • List customization assets
      • Update an asset's alt text / display name
      • Delete a customization asset
      • Get checkout fields config
      • Update checkout fields config
      • Save InstaPay credentials
      • Get InstaPay credentials status
      • Remove InstaPay credentials
      • Save Vodafone Cash credentials
      • Get Vodafone Cash credentials status
      • Remove Vodafone Cash credentials
      • Save WE Pay credentials
      • Get WE Pay credentials status
      • Remove WE Pay credentials
      • Save Orange Cash credentials
      • Get Orange Cash credentials status
      • Remove Orange Cash credentials
      • Upload merchant-generated InstaPay QR image
      • Remove the uploaded InstaPay QR image
      • Get all tracking settings
      • Get the tracking-credential validation contract
      • Save Meta Pixel + CAPI settings
      • Disconnect Meta tracking
      • Send a synthetic Purchase test event to Meta
      • Get recent Meta CAPI events
      • Verify the Meta Pixel against Meta
      • Get Meta Event Match Quality
      • Get Meta tracking status
      • Save TikTok Pixel + Events API settings
      • Disconnect TikTok tracking
      • Send a synthetic Purchase test event to TikTok
      • Get recent TikTok Events API events
      • Get TikTok Events API deliveries that failed
      • Re-send failed TikTok Events API deliveries
      • Verify the TikTok Pixel against TikTok
      • Get TikTok tracking status
      • Get TikTok Marketing ad-performance report
      • Connect TikTok Shop (persist token + shop)
      • TikTok Shop connection status
      • Disconnect TikTok Shop
      • Get onboarding progress
      • Complete an onboarding step
      • Skip an onboarding step
      • Dismiss onboarding
      • Restore dismissed onboarding
      • Auto-configure store from wizard answers
      • List reconciliation runs
      • Get mismatches for a reconciliation run
      • Resolve or reopen a reconciliation mismatch
      • Trigger reconciliation for a date
      • Payment volume broken down by gateway
      • List shipping zones
      • Create a shipping zone
      • Get a shipping zone
      • Update a shipping zone
      • Deactivate (soft-delete) a shipping zone
      • Create a rate on a zone
      • Update a rate
      • Deactivate a rate
      • Return covered/uncovered governorates for the store
      • Apply the Quick Start: Egypt 4-zone preset
      • Preview rates for a cart (merchant calculator tool)
      • Get Balances
      • List Transactions
      • List Invoices
      • List installable apps
      • List installs for this store
      • Install an app
      • Update app settings
      • Disable app
      • Enable app
      • Uninstall app
      • Void a payment the merchant recorded by hand
      • Print the invoice for an order, paid or not
      • Signed link to a Partner App's own admin
      • The store's subscription to a paid app
      • Pay for a paid app from the store's wallet
      • Cancel a paid app at the end of the paid period
      • Re-send failed Meta Conversions API deliveries
    • Analytics
      • Get dashboard statistics
      • Get revenue chart data
      • Get top selling products (dashboard)
      • Get daily order streak
      • Get sales overview
      • Get sales chart data
      • Get top selling products (analytics)
      • Get sales by location
      • Get customer analytics
      • Get conversion statistics
      • Get orders by traffic source
      • Get COD rejection statistics
      • Get merchant health score
      • Get orders breakdown analytics
      • Get revenue breakdown analytics
      • Get customer RFM segmentation
      • Get inventory analytics (sell-through, ABC, dead stock)
      • Get product performance analytics
      • Get top storefront search terms
      • Customer health scores + states
      • Statistical predictions (stockouts, bands, repeat, COD)
      • Get active advisor signals
      • Dismiss an advisor signal
      • Re-run the advisor rules for this store now
      • Executive dashboard — what should I do today?
      • Anonymous peer benchmarks (k-anonymity gated)
      • Custom report: metrics grouped by a chosen dimension
      • Get weekly-digest preferences
      • Set weekly-digest preferences
      • Preview the weekly analytics digest
      • Get store-event annotations for charts
      • Get metric targets with live pace
      • Set metric targets
      • Get conversion funnel
      • Get marketing attribution analytics
      • Get customer LTV by first-touch acquisition channel
      • Get AI-powered store insights
      • Get sales forecast
      • Get customer sessions list
      • Get session detail timeline
      • Multi-touch attribution per channel + campaign
      • Get real-time analytics snapshot
      • Today's orders by location (governorate)
      • SSE stream for real-time analytics
    • Customers
      • Preview a CSV customer import (parses headers + suggests mapping)
      • Execute a CSV customer import with a confirmed mapping
      • List the target fields the customer importer understands
      • List store customers
      • Create a customer manually
      • Get customer by ID
      • Get customer COD trust network stats
      • Erase a customer's analytics footprint (DSAR)
      • Get a customer's full touchpoint journey
      • Conversations linked to this customer
      • Adopt a linked conversation's profile picture as the customer photo
    • Marketing
      • Create new coupon
      • List coupons
      • Get coupon by ID
      • Update coupon
      • Delete coupon
      • Bulk-update promotion priorities (drag-to-reorder)
      • Issue a short-lived preview token for the builder iframe
      • List promotions for a store
      • Create a new promotion
      • Get a single promotion by id
      • Update a promotion (optimistic lock via `version`)
      • Soft-delete (archive) a promotion
      • Duplicate a promotion as a new draft
      • Move a promotion to ACTIVE
      • Move a promotion to PAUSED
      • Move a promotion to ARCHIVED
      • Aggregate analytics for one promotion within a date range
      • List social connections
      • Connect social account
      • Disconnect social account
      • Fetch posts from connected account
      • Import social posts as draft products
      • Import products from Instagram/Facebook post URLs
      • Get Meta Embedded Signup config
      • Complete WhatsApp embedded signup
      • Disconnect WhatsApp Business
      • Get WhatsApp connection status
      • Get WhatsApp notification settings
      • Update WhatsApp notification settings
      • Get WhatsApp analytics
      • List recent WhatsApp messages
      • Connect merchant's own Meta WABA (BYO)
      • Disconnect BYO Meta WABA and revert to platform-managed
      • Get WhatsApp connection status (BYO-aware)
      • Update store-level WhatsApp preferences (e.g. message language)
      • Update notification toggles (BYO-path)
      • Get the store's WhatsApp access-gate state
      • Open (or resume) the bill for this store's WhatsApp access
      • Request WhatsApp access for this store (merchant)
      • List WhatsApp templates
      • Create WhatsApp template
      • Delete WhatsApp template
      • Sync template statuses from Meta
      • List registered email events
      • Get registry default template for an event/language
      • List merchant email templates
      • Create email template override
      • Get email template by ID
      • Update email template
      • Delete email template
      • Preview an unsaved email-template draft
      • Preview a saved email template
      • Send a test email rendered from this template
      • List conversations (inbox)
      • Get unread conversation count
      • Get messages for a conversation
      • Send a message in a conversation
      • Update conversation (mark read, archive, assign)
      • List campaigns
      • Create campaign draft
      • Get campaign details
      • Update campaign draft
      • Send campaign now
      • Schedule campaign
      • Cancel scheduled campaign
      • List campaign recipients
      • Estimate audience size
      • List Opt Ins
      • Create Opt In
      • Revoke Opt In
      • List Scheduled Sends
      • Create Scheduled Send
      • Get Scheduled Send
      • Cancel Scheduled Send
      • List Dead Letters
      • Get Dead Letter
      • Replay Dead Letter
      • Connect Meta
      • Meta Callback
      • Connect Assets
      • Sync History
      • Disconnect Channel
      • List Connections
      • List Threads
      • Get Thread
      • Mark Read
      • Resolve Thread
      • Link Customer
      • Unlink Customer
      • List Messages
      • Send Message
      • Create Template
      • List Templates
    • Online store
      • List menus
      • Create menu
      • Get menu by handle
      • Update (or create) a menu by handle
      • Delete menu
      • List pages
      • Create page
      • Get page by handle
      • Update (or create) a page by handle
      • Delete page
      • List all themes available to a store (built-in + external)
      • Submit External Theme
      • Get External Theme Info
      • Remove External Theme
      • Connect a local theme dev server (numu-theme dev)
      • Get Build Status
      • Rebuild External Theme
      • Validate External Theme
      • List all theme installations for a store
      • Install a theme on the store
      • Get a specific installation
      • Rename a theme installation
      • Uninstall a theme from the store
      • Duplicate a theme installation into a new draft copy
      • Export an installation as a portable JSON document
      • Activate an installed theme
      • Save draft customization (not yet live)
      • Publish draft customization (goes live)
      • Generate a preview URL for an installation
      • List the store's theme workspace files
      • Read one workspace file
      • Create or overwrite a workspace file
      • Delete a workspace file
      • Seed a buildable starter theme into the workspace
      • Build & publish the code-editor workspace
      • Get Draft
      • Autosave Draft
      • Publish
      • List Versions
      • Get Version Payload
      • Restore Version
      • Discard Draft
      • Get Schemas
      • Resolve Theme
      • List undo entries
      • Append an undo entry
      • Clear undo stack
      • Remove an undo entry (after applying)
    • OAuth
      • Token
      • Revoke
  1. Orders & fulfillment

Request a refund for an order

POST
https://numueg.app/api/v1/stores/{store_id}/orders/{order_id}/refunds
Last modified:2026-09-19 16:39:33
x-numu-scope:orders:write
Create a refund request for an order.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Body Params application/jsonRequired

Examples

Responses

🟢201
application/json
Successful Response
Bodyapplication/json

🟠422
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://numueg.app/api/v1/stores//orders//refunds' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "reason": "customer_request",
    "reason_note": "Customer changed their mind",
    "refund_type": "full"
}'
Response Response Example
201 - Example 1
{
    "success": true,
    "data": {
        "id": "string",
        "order_id": "string",
        "store_id": "string",
        "refund_number": "string",
        "refund_type": "string",
        "status": "string",
        "reason": "string",
        "reason_note": "string",
        "amount": 0,
        "currency": "string",
        "payment_provider": "string",
        "payment_id": "string",
        "provider_refund_id": "string",
        "requested_by": "string",
        "approved_by": "string",
        "rejected_by": "string",
        "processed_at": "2019-08-24T14:15:22.123Z",
        "completed_at": "2019-08-24T14:15:22.123Z",
        "rejected_at": "2019-08-24T14:15:22.123Z",
        "failure_reason": "string",
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z"
    },
    "message": "string"
}
Modified at 2026-09-19 16:39:33
Previous
Send the order's payment link into a linked conversation
Next
List refunds for an order
Built with