Skip to main content
DELETE
/
v1
/
ugwo
/
{ugwoUid}
curl -X DELETE https://api.kwugwo.africa/v1/ugwo/ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE \
  -H "Authorization: Bearer $KWUGWO_SECRET_KEY"

{
  "uid": "ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE",
  "status": "cancelled",
  "amount": 500000,
  "currency": "NGN"
}

Documentation Index

Fetch the complete documentation index at: https://docs.kwugwo.africa/llms.txt

Use this file to discover all available pages before exploring further.

Moves the ugwo to the cancelled status. Use this to close out abandoned carts or orders the customer aborted.
An ugwo can only be cancelled while it is in requires_ugwo. Once any activity has been started against it — and certainly once it has been paid — the cancel call returns an error. There are no refunds via cancel; refunds are handled separately.
Current statusResult
requires_ugwoTransitions to cancelled.
processing / ugwo_successful / refunded / partially_refunded / cancelled409 Conflict.

​
Path parameters

​
ugwoUid
string
required
The ugwo ID — ugw.XXXX.YYYY....

​
Response

Returns the cancelled ugwo with status: "cancelled". 
curl -X DELETE https://api.kwugwo.africa/v1/ugwo/ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE \
  -H "Authorization: Bearer $KWUGWO_SECRET_KEY"

{
  "uid": "ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE",
  "status": "cancelled",
  "amount": 500000,
  "currency": "NGN"
}