We want to ensure complete transparency regarding how your SMS credits are consumed and when you are eligible for a refund in the event of a message delivery failure. Our platform routes messages through our trusted gateway partners, and refund eligibility depends on the specific reason for the failure.
Here is a comprehensive guide to understanding which delivery statuses are refundable and which are non-refundable.
General Refund Policy
As a general rule:
- Refundable: You will be refunded (or not charged) if a message fails to leave our system or the gateway due to internal errors, authentication issues, or insufficient balance.
- Non-Refundable: You will not be refunded once a message has been successfully handed over to the telecom carrier. If the carrier rejects the message (e.g., due to DND registry, invalid number, blocked content, or network issues), the credit is consumed as the carrier still charges for the processing attempt.
DataGenit Gateway
Datagenit explicitly categorizes specific gateway errors as refundable. Generally, errors originating from the gateway's validation or connection are refunded, while DLT (Distributed Ledger Technology) rejections, scrubbing failures, and carrier rejections are non-refundable.
Refundable Statuses
Credits are refunded if the message fails due to the following Gateway Errors:
Error Code
| Description
|
401
| No Auth
|
402
| Invalid Auth
|
403
| Invalid JSON format
|
404
| Page not found
|
405
| Missing required parameter
|
406
| Message Not Passed
|
407
| Access Denied
|
408
| Invalid Sender ID
|
410
| Msisdn Not Passed
|
411
| MSISDN Limit Exceed
|
412
| Insufficient Balance!
|
413
| Sender Id Not Approved
|
414
| Given country not active for your account please contact admin
|
415
| MSISDN is invalid
|
416
| Access Denied! Please coordinate with your account manager
|
417
| OTP Not Passed
|
418
| Invalid request
|
419
| Invalid OTP
|
420
| Entity ID not found
|
421
| OTP time limit exceeded
|
422
| OTP already verified for this request
|
423
| Messages Limit should not Exceed 5000
|
424
| Data Limit Exceed
|
425
| Messages Parameter not Passed
|
426
| Messages Parameter is empty
|
427
| You Don't have HTTP API permission
|
428
| Message is too large
|
429
| Your balance is low
|
430
| Invalid message template
|
431
| Passed entity_id and store entity_id with template is mismatched
|
432
| No template approved for this sender id
|
433
| Sender Id Block By Admin
|
434
| Invalid message content please check and try again
|
435
| Total number can not be zero or check your number is DND
|
437
| MSISDN Can Not Empty or invalid number
|
438
| Total number can not be zero or check your number is DND
|
439
| Invalid Route
|
440
| Schedule_time Not Passed
|
441
| No schedule_time
|
442
| Schedule_time will be greater than current time
|
443
| Logid Not Passed
|
444
| Invalid countrycode or price not available in your account
|
445
| Record not found Please check your parameters value
|
446
| No template available
|
447
| Something went wrong please try again
|
448
| Invalid entity_id
|
449
| Template id value is not correct
|
450
| Template Already Exist for this configuration
|
451
| Required parameters values cannot be empty
|
452
| Can only delete a campaign whose start time is >= 5 mins
|
453
| Date Parameter value is incorrect use YYYY-MM-DD format
|
454
| Invalid country_cd value please check
|
455
| Entity_id or template_id not passed
|
Non-Refundable Statuses
Credits are NOT refunded for successful submissions, DLT rejections, and carrier-level failures. This includes the following statuses:
Error Code
| Description
|
100
| Success (or DND)
|
203
| Success for OTP verified successfully
|
000
| DELIVERED
|
001
| UNKNOWN SUBSCRIBER
|
002
| RDS NOT SUPPORTED SERVICE
|
005
| UNIDENTIFIED SUBSCRIBER
|
006
| ABSENT SUBSCRIBER V2
|
007
| UNKNOWN EQUIPMENT
|
008
| FSM TIMEOUT
|
009
| ILLEGAL SUBSCRIBER
|
010
| INVALID SOURCE ADDRESS
|
011
| TELESERVICE NOT PROVISIONED
|
012
| ILLEGAL EQUIPMENT
|
013
| OPERATOR CALLBARRED
|
015
| CUG REJECT
|
020
| Multiple Submissions on Single Number
|
021
| FACILITY NOT SUPPORTED
|
023
| POWER REGISTRATION FAILURE
|
024
| MAPUE_NEGATIVE_PW_CHECK
|
025
| NO HANDOVER NUMBER AVAILABLE
|
027
| ABSENT SUBSCRIBER
|
029
| SHORT TERM DENIAL
|
031
| SUBSCRIBER BUSY FOR MT SMS
|
032
| MEMORY CAPACITY EXCEEDED
|
033
| MESSAGE WAITING LIST FULL
|
034
| SYSTEM FAILURE
|
035
| DATA MISSING
|
036
| UNEXPECTED DATA VALUE
|
037
| SM-DELIVERY FAILURE
|
038
| INITIATING_RELEASE
|
050
| UNKNOWN ERROR
|
063
| GT ERROR
|
074
| INVALID HEADER IN MSG
|
087
| PROVIDER ERROR
|
088
| SRI TIMEOUT
|
089
| INVALID PACKET AT SMSC LEVEL
|
090
| USER-ABORT
|
091
| PROVIDER-ABORT
|
092
| MSC NUMBER MISSING
|
093
| Equipment protocol error
|
094
| Equipment not SM equipped
|
095
| Unknown service centre
|
096
| Service Centre congestion
|
097
| INVALID SCHEDULE DELIVERY TIME
|
098
| Subscriber not SC subscriber
|
099
| Invalid SME address
|
101
| ACCOUNT DETAILS NOT FOUND AT ROUTING
|
102
| SENDER ID BLOCKED
|
103
| ROUTE NOT ACTIVE
|
104
| OFF-NET NOT ACTIVE / ON-NET ROUTES NOT DEFINED
|
105
| ON-NET NOT ACTIVE / OFF-NET ROUTES NOT DEFINED
|
106
| ROUTES NOT CONFIGURED FOR ACCOUNT
|
107
| ROUTING DISABLE FOR ACCOUNT
|
108
| ROUTE BLOCKED FOR THIS SERIES
|
109
| MSISDN SERIES NOT CONFIGURED
|
110
| NOT ABLE TO GET FINAL ROUTE
|
111
| SPAM KEYWORD FOUND
|
112
| NOT A VALID TEMPLATE
|
113
| MANDATORY WORDS NOT FOUND
|
114
| DEFAULT ROUTE NOT FOUND IN CONFIGURED ROUTES
|
115
| ROUTE NOT CONFIGURED AT PLATFORM LEVEL
|
123
| INTERNATIONAL ROAMING
|
124
| MESSAGE EXPIRED AT SMSC LEVEL
|
195
| Expected TLV missing
|
200
| OPERATOR BLOCKED FOR ACCOUNT
|
221
| MSISDN BLOCKED
|
222
| MESSAGE CONTENT IS BLACKLISTED
|
224
| MESSAGE CONTENT BLOCKED REGEX
|
225
| MESSAGE CONTENT IS BLACKLISTED AT OPERATOR
|
252
| MESSAGE VALIDITY EXPIRED
|
600-609
| ENTITY NOT FOUND / INACTIVE / BLACKLISTED / RESERVED
|
610-619
| TELEMARKETER ERRORS / BLACKLISTED / INVALID TEMPLATE
|
620-629
| HEADER ERRORS / INACTIVE / BLACKLISTED / RESERVED
|
630-649
| TEMPLATE ERRORS / INVALID VARIABLE LENGTH / RESERVED
|
650-659
| PREFERENCE NOT MATCHED / RESERVED
|
660-668
| CONSENT FAILED / RESERVED / CONTENT MIS-MATCH
|
669-699
| SCRUBBING ERRORS / INVALID TM_ID / HEADER MISMATCH
|
801-804
| BLACKLISTED ENTITY / INACTIVE ENTITY / HEADER
|
1026
| Check Template
|
1033
| CREDIT LIMIT EXCEEDED
|
4001, 4107, 5000-5001
| DLT_SCRUBBING_TIMEOUT
|
4106, 5101-5108
| BLOCKED_BY_DLT
|
4108, 5201-5205
| SENDER_BLOCKED_BY_DLT
|
5301-5307, 5401-5407
| TEMPLATE_ERROR
|
7001-7003
| ENTITY_ID_ERROR
|
undeliverable
| UNDELIVERABLE (Internal status)
|