Reloadly\u2019s Airtime API enables you to fetch the real-time status of every airtime top-up you make. Response times from various operators may differ and due to this, we want to ensure that you have every information about the status of your top-ups.<\/p>\n\n\n\n
Top-ups can have one of the following four statuses:<\/p>\n\n\n\n
SUCCESSFUL<\/strong>: This applies when the top up is successfully made.<\/p>\n\n\n\n PROCESSING<\/strong>: This applies while the top up is still being verified from the operator’s end.<\/p>\n\n\n\n REFUNDED<\/strong>: This applies once the top up is not processed successfully from the airtime operator’s end. In this instance, any funds debited from a user’s wallet while attempting to make the top-up are automatically refunded. <\/p>\n\n\n\n FAILED<\/strong>: This applies when the top-up attempt fails due to an internal error from the operator’s end. In this instance, you should wait 30 minutes before reinitiating the top-up. Funds are not debited for a failed top-up attempt.<\/p>\n\n\n\n We have added four code snippets that show what the JSON response of each of these statuses look like. This way, you can gain further insights on each of the statuses:<\/p>\n\n\n\n SUCCESSFUL TOP-UP<\/strong><\/p>\n\n\n\n PROCESSING TOP-UP<\/strong><\/p>\n\n\n\n REFUNDED TOP-UP<\/strong><\/p>\n\n\n\n FAILED TOP-UP<\/strong><\/p>\n\n\n\n The Get Top-up Status service (https:\/\/topups.reloadly.com\/topups\/{transactionId}\/status<\/a>) enables you to have proper insight into the flow of each top-up you make. This guide aims to summarize and explain how it works. Should you have any questions, you can reach out to our engineers via our developer community<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":" This article aims to show users how Reloadly’s “Get Status” endpoint works for Airtime top-ups.<\/p>\n","protected":false},"author":17,"featured_media":2572,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[274],"tags":[11,277,282,397],"yoast_head":"\n{\n \"transactionId\": 26523,\n \"status\": \"SUCCESSFUL\",\n \"operatorTransactionId\": null,\n \"customIdentifier\": \"This is example identifier\",\n \"recipientPhone\": \"447951631337\",\n \"recipientEmail\": null,\n \"senderPhone\": \"11231231231\",\n \"countryCode\": \"GB\",\n \"operatorId\": 535,\n \"operatorName\": \"EE PIN England\",\n \"discount\": 63.37,\n \"discountCurrencyCode\": \"NGN\",\n \"requestedAmount\": 3168.4,\n \"requestedAmountCurrencyCode\": \"NGN\",\n \"deliveredAmount\": 5,\n \"deliveredAmountCurrencyCode\": \"GBP\",\n \"transactionDate\": \"2022-01-26 03:19:16\",\n \"pinDetail\": {\n \"serial\": \"558111\",\n \"info1\": \"DIAL *611\",\n \"info2\": \"DIAL *611\",\n \"info3\": \"Dial *233* and PIN #\",\n \"value\": null,\n \"code\": \"773709733097662\",\n \"ivr\": \"1-888-888-8888\",\n \"validity\": \"30 days\"\n },\n \"balanceInfo\": {\n \"oldBalance\": 60387.41,\n \"newBalance\": 57282.38,\n \"cost\": 3105.03,\n \"currencyCode\": \"NGN\",\n \"currencyName\": \"Nigerian Naira\",\n \"updatedAt\": \"2022-01-26 08:19:16\"\n }\n}\n<\/code><\/pre>\n\n\n\n{\n \"code\":null,\n \"message\":null,\n \"status\":\"PROCESSING\",\n \"transaction\":null\n}\n<\/code><\/pre>\n\n\n\n{\n \"code\": \"SERVICE_TO_OPERATOR_TEMPORARILY_UNAVAILABLE\",\n \"message\": \"The transaction failed due to an outage and \/ or connection issue with the operator\",\n \"status\": \"REFUNDED\",\n \"transaction\": null\n}\n<\/code><\/pre>\n\n\n\n{\n \"code\":\"PROVIDER_INTERNAL_ERROR\",\n \"message\":\"Please wait 30 minutes to purchase same product\",\n \"status\":\"FAILED\",\n \"transaction\":null\n}\n<\/code><\/pre>\n\n\n\nConclusion<\/h2>\n\n\n\n