Merchandise and orders

Church merchandise (books, T-shirts, event items) listed in the app, and an order paid with an M-Pesa prompt.

Premium

Listing merchandise needs the church's premium plan; a basic church answers Your church is currently not subscribed to this feature.

List merchandise

GEThttps://uat-api.mychurch.co.ke/api/v2/merchandiseMember token, premium

bash

curl https://uat-api.mychurch.co.ke/api/v2/merchandise \
  -H "Authorization: Bearer 11111111-2222-4333-8444-555555555555"

Response

{
  "message": "Success",
  "status": true,
  "merchandise": [
    { "uuid": "00000000-0000-4000-8000-000000000701", "name": "Church T-shirt", "description": "Cotton, all sizes",
      "poster": "https://uat-api.mychurch.co.ke/storage/scarlet/merchandise/tshirt.jpg", "amount": "1200.00" }
  ]
}

Only items the church has listed. On /api/v1, amount is formatted ("1,200.00") and each item carries "type": 2.

Place an order

POSThttps://uat-api.mychurch.co.ke/api/v2/order/make-order/{merchandise}Member token

Parameters

Field	Type	Required	Description
quantity	integer	Yes	At least 1.
phone	string	No	The number to prompt; defaults to the member's.

bash

curl -X POST https://uat-api.mychurch.co.ke/api/v2/order/make-order/00000000-0000-4000-8000-000000000701 \
  -H "Authorization: Bearer 11111111-2222-4333-8444-555555555555" \
  -H "Content-Type: application/json" \
  -d '{"quantity": 2}'

Response

{"message": "Your order has been placed. Please input your pin when prompted", "status": true}

The order is recorded with a generated MERCH- order number (for example MERCH-52190) and a prompt for quantity times price goes to the phone. The order is marked paid once the payment is verified; the church sees it in the portal. Failures: 404 for an item of another church or an unknown uuid, 422 for a bad quantity, Your church has no paybill configured for payments.

A customer can also pay an order directly to the church paybill with the order number as the account (account numbers).