Payment Transaction Status

Payment Transaction Status Codes

Code	Status	Description	Action required	Subscriber-friendly message
0	PaymentCompletedSuccessfully	Payment completed successfully.	No action required	English: “Thank you for subscribing” Arabic: “شكرا لأشتراكك”
1	FailedToSendVerificationPin	Failed to send PIN code verification.	Ask tpay’s Integration team for support.	English: “Please try again or contact us.” Arabic: “يرجى المحاولة فى وقت لاحق أو تواصل معنا”
2	TransactionCancelledByUser	Transaction was cancelled by them.	Make sure you are taking it from AddSubscriptionContractRequest API.	English: “The process has been cancelled from your side.” Arabic: “تم إلغاء العملية من جانبك”
3	FailedToContactMobileNetworkOperator	Failed to contact mobile network operator to perform charging.	No action required	English: “Please try again or contact us.” Arabic: “يرجى المحاولة فى وقت لاحق أو تواصل معنا”
4	NotEnoughCredit	They don’t have enough credit (prepaid lines).	No action required	English: “You don’t have enough balance.” Arabic: “ليس لديك رصيد كافي”
5	LimitExceeded	They exceeded daily or monthly limits (postpaid lines).	No action required	English: “You exceeded daily or monthly limits.” Arabic: “لقد تجاوزت الحدود اليومية أو الشهرية”
6	OperationRejectedByMobileNetworkOperator	The operation rejected by the mobile network operator.	Ask tpay’s Integration team for support.	English: “Please try again or contact us.” Arabic: “يرجى المحاولة فى وقت لاحق أو تواصل معنا”
7	OperationRejectedBytpay	The operation was administratively cancelled by T-Pay service.	Ask tpay’s Integration team for support.	English: “Please try again or contact us.” Arabic: “يرجى المحاولة فى وقت لاحق أو تواصل معنا”
8	InactiveLine	Operation rejected by T-Pay service because they are blacklisted.	Ask tpay’s Integration team for support.	English: “Please try again or contact us.” Arabic: “يرجى المحاولة فى وقت لاحق أو تواصل معنا”
9	UnspecifiedError	Unspecified error occurred.	Ask tpay’s Integration team for support.	English: “Please try again or contact us.” Arabic: “يرجى المحاولة فى وقت لاحق أو تواصل معنا”
10	VerificationCodeSent	They received the PIN code but made no further action.	Guide them to verify the payment.	English: “Please follow instructions in USSD Menu” Arabic: “يرجى اتباع قائمة التعليمات” English: “Please confirm your payment.” Arabic: “يرجى تأكيد الدفع الخاص بك”
11	InvalidPIN	Invalid PIN entered by them	No action required	English: “Entered PIN code is invalid.” Arabic: “كود التحقق الذي تم إدخاله غير صالح”
12	Created	The Transaction was created “for PSMS API only”.	No action required	English: “Please confirm your payment.” Arabic: “يرجى تأكيد الدفع الخاص بك”
13	SubscriberDoesNotExist	The MSISDN doesn’t exist in the specified operator.	No action required	English: “Phone number provided doesn’t exist in the chosen mobile operator.” Arabic: “رقم الهاتف المقدم غير موجود في مشغل الهاتف المحمول المختار”
14	CorporateNotEligible	The subscriber line is a corporate postpaid line and not Eligible	No action required	English: “Your phone number is not eligible for this operation. Please contact your mobile operator.” Arabic: “رقم هاتفك غير مؤهل لهذه العملية. يرجى الاتصال بمشغل الهاتف المحمول الخاص بك”
15	MobileNetworkOperatorChargingError	Charging error from the mobile operator side	Ask tpay’s Integration team for support	English: “Please try again or contact us.” Arabic: “يرجى المحاولة فى وقت لاحق أو تواصل معنا”
16	ExpiredPinCode	PIN code entered is expired.	Restart the payment flow by sending a request to Initialization API	English: “PIN code entered is expired/ We have sent a new one.” Arabic: “كود التحقق المدخل منتهي الصلاحية. لقد أرسلنا واحد جديد”
17	Reverted	The transaction has been reverted	Ask tpay’s Integration team for support	English: “Your payment has been reverted.” Arabic: “تم إرجاع دفعتك”
18	NotSupportedPricePoint	The configured price point is not supported from operator side.	Revise the configured price point and contact your sales manager	English: “Please try again or contact us.” Arabic: “يرجى المحاولة فى وقت لاحق أو تواصل معنا”
19	TimeOut	Transaction process timed out.	If the issue persists, contact tpay’s Integration team	English: “Please try again or contact us.” Arabic: “يرجى المحاولة فى وقت لاحق أو تواصل معنا”
20	InvalidPassword	Invalid Password	No action required	English: “Please try again or contact us.” Arabic: “يرجى المحاولة فى وقت لاحق أو تواصل معنا”
21	PendingTransaction	The transaction process is not completed yet.	Guide them to check again after one minute	English: “Please check again in one minute.” Arabic: “يرجى التحقق مرة أخرى بعد دقيقة واحدة”
22	PartiallyCollected	Part of the payment has been collected	Guide them to contact tpay support	English: “Your payment has been partially collected.” Arabic: “تم جمع جزء من دفعتك”
50	TransactionUnderProcessing	Transaction under processing “for PSMS API only.”	No action required	English: “Please try again or contact us.” Arabic: “يرجى المحاولة فى وقت لاحق أو تواصل معنا”
51	Error	Validation error has occurred	No action required	English: “Please try again or contact us.” Arabic: “يرجى المحاولة فى وقت لاحق أو تواصل معنا”
100	SucceededAndFailedToContactMerchant	Payment succeeded, but push notification failed to be delivered. This status is for Initial payment model.	Please consider this status as a success, but check why your system hadn’t responded to this notification with (200OK)	English: “Please try again or contact us.” Arabic: “يرجى المحاولة فى وقت لاحق أو تواصل معنا”
101	SucceededAndRetryAttemptReached	Payment succeeded, and our system tried to send the push notification 48 retries without a successful delivery.	Please consider this status as a success, but check why your system hadn’t responded to this notification with (200OK)	English: “Please try again or contact us.” Arabic: “يرجى المحاولة فى وقت لاحق أو تواصل معنا”