Seller Fulfillment

Complete pickup handoff

POST/api/v1/orders/:id/complete-pickup

Confirms the buyer picked up the order in person, by scanning their QR code.

Requires Authorization

SELLER only

Session

Path parameters

idstringrequired

Must belong to one of the seller's shops.

Body parameters

qrTokenstringrequired

From the buyer's GET /:id/qr-code, resolved via POST /scan.

Request

curl --request POST \
  --url https://api.swiftgoma.com/api/v1/orders/:id/complete-pickup \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "qrToken": "<qrToken>"
}'

200Example response

{
  "success": true,
  "data": {
    "id": "ord_5e6f7a",
    "buyerId": "3f2a1c9e",
    "shopId": "shop_2b3c4d",
    "status": "COMPLETED",
    "fulfillmentMethod": "PICKUP",
    "paymentMethod": "MOBILE_MONEY",
    "currency": "USD",
    "deliveryAddress": "12 Avenue du Lac, Goma",
    "deliveryFee": "2.00",
    "subtotal": "25.00",
    "total": "27.00",
    "items": [
      {
        "id": "oitem_1a2b3c",
        "productId": "prod_7c8d9e",
        "variantId": "var_4d5e6f",
        "name": "Riz parfumé 25kg",
        "quantity": 2,
        "unitPrice": "12.50",
        "lineTotal": "25.00"
      }
    ],
    "createdAt": "2026-02-15T09:00:00.000Z",
    "updatedAt": "2026-02-15T09:00:00.000Z"
  }
}