Error Codes

Overview

The StarPay API uses standard HTTP status codes together with application-specific error codes to indicate why a request failed. Each error includes a unique code that helps you quickly identify and resolve issues during integration.

Error Reference

HTTP Status	Error Code	Message
404	TRDP_001	Merchant not found.
404	TRDP_002	Payment not found.
400	TRDP_014	USD card payment is not enabled for this merchant. Please contact support to enable usd payment.
400	TRDP_003	Failed to create payment order transaction.

Best Practice: Each error code represents a specific failure condition. Avoid reusing the same error code for different errors—this makes troubleshooting much easier for merchants integrating with your API.

Error Response Format

All error responses follow a consistent structure for predictable error handling:

{
  "error": {
    "code": "TRDP_003",
    "message": "Failed to create payment order transaction."
  }
}

Error Response Examples

404 - Merchant Not Found

When the merchant account cannot be located.

HTTP/1.1 404 Not Found

{
  "error": {
    "code": "TRDP_001",
    "message": "Merchant not found."
  }
}

404 - Payment Not Found

When the payment record cannot be found in the system.

HTTP/1.1 404 Not Found

{
  "error": {
    "code": "TRDP_002",
    "message": "Payment not found."
  }
}

400 - USD Payment Not Enabled

When USD payment processing has not been enabled for the merchant account.

HTTP/1.1 400 Bad Request

{
  "error": {
    "code": "TRDP_014",
    "message": "USD card payment is not enabled for this merchant. Please contact support to enable usd payment."
  }
}

Common Error Codes Reference

Error Code	Meaning	Resolution
TRDP_001	Merchant not found	Verify that your merchant ID is correct and your account is active.
TRDP_002	Payment not found	Check that the payment ID is valid and corresponds to an existing transaction.
TRDP_003	Order creation failed	Review the payment request parameters and ensure all required fields are valid.
TRDP_014	USD payment not enabled	Contact support at support@starpayethiopia.com to enable USD payments for your account.

Payment Verification

Test Numbers

Get started

Api Reference

Overview

Error Reference

Error Response Format

Error Response Examples

Common Error Codes Reference

​Overview

​Error Reference

​Error Response Format

​Error Response Examples

​Common Error Codes Reference

Overview

Error Reference

Error Response Format

Error Response Examples

Common Error Codes Reference