v1

latestOpenAPI 3.0.32026-07-264414182.7 KB
Payment Code

List Payment Codes

Retrieves a list of payment codes with support for filtering by mode, USSD code, and status.

get/v1/payment-codes

Query parameters

ussd_codestring nullable

Filter by the USSD code assigned to the payment code (if applicable).

Filter by the USSD code assigned to the payment code (if applicable).

mode'one_time' | 'recurrent' nullable

Filter by usage mode: 'one_time' for single-use codes, or 'recurrent' for reusable ones.

Filter by usage mode: 'one_time' for single-use codes, or 'recurrent' for reusable ones.

status'pending' | 'cancelled' | 'processing' | 'expired' | 'completed' nullable

Filter by payment code status: 'pending' (not yet used), 'processing' (in use), 'expired' (duration elapsed), 'cancelled' (manually cancelled), or 'completed' (fulfilled as intended).

Filter by payment code status: 'pending' (not yet used), 'processing' (in use), 'expired' (duration elapsed), 'cancelled' (manually cancelled), or 'completed' (fulfilled as intended).

limitinteger

Maximum number of items to return in a single page. Must be between 1 and 50. Defaults to 10 if not specified.

Maximum number of items to return in a single page. Must be between 1 and 50. Defaults to 10 if not specified.

afterstring nullable

Pagination cursor for fetching the next page of results. Set this to the 'next' cursor value from a previous response to continue paginating forward.

Pagination cursor for fetching the next page of results. Set this to the 'next' cursor value from a previous response to continue paginating forward.

Headers

Monime-Space-Idstring required

The value is the tenancy parameter that Monime uses to determine which space the request is intended for.

The value is the tenancy parameter that Monime uses to determine which space the request is intended for.

Monime-Version'caph.2025-08-23' | 'caph.2025-06-20' nullable

Specifies which version of the Monime API will handle this request.

Specifies which version of the Monime API will handle this request.

Response

OK

successboolean

Represents the status of the query operation, confirming if it was successful. This field is always true