OPay Error Codes

The OPay initialize endpoint can return validation errors when a request fails validation.

Validation Error

If validation fails, the API returns HTTP 400 Bad Request.

{
    "status": false,
    "message": "The email field is required.",
    "error": {
        "email": ["The email field is required."],
        "amount": ["The amount field is required."]
    }
}

Error Fields

Field	Type	Description
`status`	boolean	`false` when validation fails.
`message`	string	Human-readable validation message.
`error`	object	Field-level validation errors.
`error.email`	array	Validation errors for the `email` field.
`error.amount`	array	Validation errors for the `amount` field.

Request Validation Rules

Parameter	Type	Required	Validation Rules
`email`	string	Required	Valid email address, minimum 6 characters
`amount`	numeric	Required	Minimum value: 1
`reference`	string	Optional	Min 16 characters, max 33 characters
`first_name`	string	Optional	Maximum 100 characters
`last_name`	string	Optional	Maximum 100 characters
`callbackUrl`	string	Optional	Must be a valid URL

Webhooks / Notifications Overview