v3 SMS HTTP
Receive Confirmation of Credit
OpenMarket sends this notification when the status of an attempted credit changes. The type of credit notification is identified by the creditState parameter, as either:
- confirmed — The mobile operator has applied the credit to the mobile phone account.
- failed — The credit request failed. You will be able to determine why using the outcomeReasonId code.
Each credit attempted is identified with a unique creditId. The creditId is returned in all notifications about the credit.
Quick facts
Method |
GET |
Response required |
HTTP 200 with a non-empty body |
Available |
United Kingdom |
Prerequisites |
You must have Crediting provisioned with OpenMarket. |
More information |
Request from OpenMarket
The request from OpenMarket includes data in the URL and request header. There are no parameters included in request body.
Example confirmed credit request
http://server.example.com/crediting?creditId=78858761&updateId=4685246&creditState=confirmed&date=2013-04-29+11%3A46%3A12+%2B0100&carrierid=348&msisdn=447700900765&billingType=postpay
Failed requests include an outcomeReasonId. This identifies why the credit failed.
Example failed credit request
http://server.example.com/crediting?creditId=63944542&updateId=6451659&creditState=failed&date=2013-02-09+14%3A55%3A40+%2B0000&msisdn=447700900999&outcomeReasonId=50528769&outcomeReasonText=The+price+point+is+not+provisioned+on+this+brand.+Please+contact+your+account+manager+to+confirm+your+configured+price+points.&carrierid=348
Query parameters
Parameter |
Description |
---|---|
creditId |
An ID that uniquely identifies the original credit request. This is a 64-bit unsigned integer. Returned: Always |
updateId |
A unique ID identifying the specific update to the given credit. This can be used to filter duplicate updates if received. Returned: Always |
creditState |
Identifies the type of notification and the current state of the credit.
Returned: Always |
date |
The date and time of the update in the format: yyyy-MM-dd HH:mm:ss [timezone] The time zone indicated is relative to GMT; e.g.: 2013-04-29 14:31:02 +0100. Returned: Always |
msisdn |
The mobile phone number of the end user. This will be in international format with no leading "+" character; for example: 447700900750. Returned: Always |
carrierid |
A numeric ID representing the mobile operator as known by OpenMarket (e.g., 383 for AT&T and 77 for Verizon Wireless). Returned: Always |
billingType |
The account type of the mobile phone; either prepay or postpay. Returned: When available |
outcomeReasonId |
Code defining the reason for the outcome of the request. For the list of codes used in notifications, see outcomeReasonId codes below. Returned: Only when required |
outcomeReasonText |
Natural language description of the outcome. Returned: Only when required |
outcomeReasonId codes
If there was an issue with the credit request, then the notification from us includes an outcomeReasonId.
Code |
Description |
---|---|
50397442 |
This mobile operator has reached its credit limit and will not accept any further credit requests until the next calendar month. Contact your account manager for more details. |
50397443 |
The MSISDN’s account has reached the allowed limit for account crediting through Mobile Crediting. This limit is set by the mobile operator. Contact your account manager for more details. |
50528513 |
This MSISDN is barred from crediting. The end user must contact their mobile operator’s customer services to lift this ban if they wish to receive credits. |
50528514 |
This MSISDN does not currently have an account with the mobile operator associated with the number. |
50528517 |
The MSISDN’s billing account does not allow credits. For example, it may be a business account. |
50528518 |
The MSISDN is on an MVNO that does not support Mobile Crediting. |
50528769 |
The price point is not provisioned on this brand. Please contact your account manager to confirm your configured price points. |
50528770 |
The MSISDN is on a mobile operator that supports Mobile Crediting but is not configured on your account. Please contact your account manager. |
50594048 |
There is an outage on the mobile operator’s system. Please check the system status notifications from OpenMarket and contact Support for further help. |
50594304 |
OpenMarket is experiencing a temporary problem processing Mobile Crediting requests. Please retry your request, and contact Support for further help. |
50594305 |
MSISDN is on an unrecognised mobile operator. |
50528771 |
MSISDN is on an unsupported mobile operator. |
Responding to the request
Your platform should return an HTTP 200 response with a non-empty body. This response must be given in a timely manner (under 10 seconds).
Troubleshooting
I'm not receiving any crediting notification
If you do not receive requests from us to an HTTPS URL, but you can receive them over standard HTTP, a possible cause is that we do not recognize and trust your server's security certificate. You must obtain an additional certificate from one of the trusted certification authorities.