Create Order (Send Bill)

Create an order and send a bill notification to a user.

Send a bill or create an order for a registered user, delivered as a notification with an optional app deep link.

POST/api/dube/international/invoice/placeorder.php

Creates an order and sends a bill notification to a user.

Base URL: https://helloomarket.com

Request headers

Header	Value	Required
`Content-Type`	`application/json`	Yes

Request body

Parameter	Type	Description
`user_id`	string	Target user identifier — from User Accounts.
`title`	string	Bill/order title shown to the user.
`body`	string	Bill/order message body.
`notificationType`	string	Notification channel/type.
`appLink`	string	Deep link opened when the notification is tapped.

Example request

curl -X POST https://helloomarket.com/api/dube/international/invoice/placeorder.php \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "usr_1024",
    "title": "Monthly contribution",
    "body": "Your November contribution of 500 ETB is due.",
    "notificationType": "push",
    "appLink": "https://your-app.com/bills/1024"
  }'

Response contract

Response fields are not yet published — log the raw response and confirm the schema with your HellOOpass integration team.

Lifecycle events

placeorder emits bill/order events to your registered webhook endpoint:

Type	When it fires
`placed`	The bill/order was created and sent to the user.
`confirmed`	The user confirmed the bill/order.
`rejected`	The user rejected the bill/order.
`success`	The bill/order completed successfully.

See Webhook Event Types.

Sending a bill is not proof of payment

A delivered notification only means the user was notified. Always verify settlement through Verify Payment before fulfilling.