Submit Delivery Information

After confirming an order, sellers use this endpoint to submit delivery information (screenshots, codes, descriptions, etc.).

Basic Information

Property	Value
Method	POST
Path	/seller/{orderId}/deliver
Authentication	Bearer Token
Content-Type	application/json

Path Parameters

Parameter	Type	Required	Description
orderId	integer	Yes	Order ID

Request Headers

Header	Type	Required	Description
Authorization	string	Yes	Bearer <accessToken>

Request Body Parameters

Parameter	Type	Required	Description
imageUrls	array[string]	No	Delivery screenshot URLs
remark	string	No	Delivery description information
content	string	No	Email content (required if isSendEmail = true)
isSendEmail	boolean	No	Whether to send email to buyer. Default: false
deliveringNumber	integer	No	Delivery quantity. Default: 1

Request Example

POST /merchant-api/seller/1689644928115784/deliver HTTP/1.1
Host: paas-gateway.imetastore.io
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json

{
  "imageUrls": ["https://example.com/delivery-screenshot.png"],
  "remark": "Redemption code delivered",
  "content": "Your code is: REDEEM-CODE-XXXX-YYYY-ZZZZ",
  "isSendEmail": true,
  "deliveringNumber": 1
}

Success Response

{
  "code": "0000",
  "msg": "Success",
  "time": "2025-12-17T13:44:16.000Z",
  "data": true
}

Important Notes

WARNING

• Only orders with status "Pending Delivery" (sellerOrderStatus = 1) can be delivered.
• Delivery information cannot be revoked once submitted — please verify before submitting.
• After delivery, the order status changes to "Pending Buyer Confirmation" (sellerOrderStatus = 4).
• For orders requiring multiple deliveries, use deliveringNumber to specify the delivery quantity.