Skip to main content
POST
/
erp
/
verify-otp-payment
Verify OTP payment
curl --request POST \
  --url https://starpayqa.starpayethiopia.com/v1/starpay-api/erp/verify-otp-payment \
  --header 'Content-Type: application/json' \
  --header 'x-api-secret: <x-api-secret>' \
  --header 'x-message-id: <x-message-id>' \
  --data '
{
  "otpCode": "686435",
  "accountNumber": "5075361069011",
  "billRefNo": "HY724Z749C"
}
'
{
  "status": "success",
  "timestamp": "2023-11-07T05:31:56Z",
  "message": "Success",
  "data": {
    "transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "billRefNo": "HY724Z749C",
    "status": "PAID",
    "amount": 100,
    "customerName": "Walk-in Customer",
    "customerPhoneNumber": "+251944719460",
    "merchantName": "kaldis hq",
    "merchantId": "6992cc567b78d101f42345a6",
    "externalReference": "075SMPC231670253",
    "paymentChannel": "OTP_ACCOUNT",
    "paidAt": "25 Mar 2026, 1:56 PM",
    "redirectUrl": "",
    "paidAmount": 100
  }
}

Headers

x-api-secret
string
required

API secret key.

Example:

"MFUxSN98EV5IUU+RhYZh2f866adcTa4F5HJ2dGI3t8+MH3cvfk/gAZ492TnxwdiI"

x-message-id
string
required

Message ID from account lookup when verifying OTP payment.

Example:

"0a162ea504918e1c85f64da9733b64bf25ff400394f8e1da6cdfb656e1338b9a8fe47e1b32429f13b1495b075857bf98"

Body

application/json
otpCode
string
required
Example:

"686435"

accountNumber
string
required
Example:

"5075361069011"

billRefNo
string
required
Example:

"HY724Z749C"

Response

OTP payment verified successfully.

status
string
required
Example:

"success"

timestamp
string<date-time>
required
message
string
required
Example:

"Success"

data
object
required