Enroll a customer using picked provider
Allows to enroll customer identified by MSISDN (phone number) using one of the available enrollment providers (e. g. FBN USSD service). Result of the enrollment will be sent with callback data.
- application/json
Request Body required
- operationId string required
Unique operation id of customer enrollment operation request
- provider CustomerEnrollmentProvider required
Possible values: [
FBN_USSD
] - customerMsisdn +234'10 digits' or 234'10 digits' or +0'10 digits' or 0'10 digits' or '10 digits' required
Possible values: Value must match regular expression
^\+?(234|0)?\d{10}$
MSISDN (phone number), available formats:
+234'10 digits'
- for example:+2341234567890
234'10 digits'
- for example:2341234567890
+0'10 digits'
- for example:+01234567890
0'10 digits'
- for example:01234567890
'10 digits'
- for example:1234567890
recoveryTokenNotificationMethod object
- oneOf
- SmsRecoveryTokenNotificationMethod
- EmailRecoveryTokenNotificationMethod
type string requiredPossible values: [
SMS
]type string requiredPossible values: [
EMAIL
]customerEmail valid email address according to "RFC 2822"E-mail address
- oneOf
- 200
- 401
- 402
- 409
Customer enrollment process was initiated
- application/json
- Schema
- Example (from schema)
- CustomerEnrollmentInitiatedWithSuccess
- CustomerEnrollmentInitiationFailed
Schema
- intiationStatus string required
Possible values: [
INITATED
,FAILED
] - message string required
Human readable message related to the Customer Enrollment operation status
- recoveryShortcodeString RecoveryShortcode required
USSD string with recovery token, which can be used by user to dial in when USSD push won't be delivered
{
"intiationStatus": "INITATED",
"message": "string",
"recoveryShortcodeString": "*425*123*55555#"
}
Customer enrollment process was initiated with success and USSD push to the customer was sent
{
"initiationStatus": "INITIATED",
"message": "Customer enrollment process was initiated with success",
"recoveryShortcodeString": "*425*123*55555#"
}
Customer enrollment process failed to initiate
{
"initiationStatus": "FAILED",
"message": "Customer enrollment process was failed to initiate",
"recoveryShortcodeString": null
}
Developer authentication failed. Please verify
Your developer balance is not enough to cover the enrollment operation cost. Please, fund your wallet
An operation with given operation ID already exists. An operation ID has to be unique