Receive card SMS rendering messages via HTTP push-Short Message Service(SMS)-阿里云帮助中心

You can receive card SMS rendering messages (MnsCardVender) via HTTP push.

Protocol

Parameter	Description
Request protocol	HTTP
Request format	application/json
Encoding	UTF-8

Request

The request payload is a JSON array that contains a single rendering status report.

Sample request

[
  {
    "mobile":"1368745****",
    "outId":"205101",
    "render_status":"0",
    "desc":"Approved",
  }
]

Fields

Parameter	Type	Description
mobile	String	The recipient's mobile number.
outId	String	The `outId` you provided when you sent the card SMS.
render_status	Integer	Indicates a successful receipt. Currently, the only value pushed is `0`.
desc	String	The receipt description.

Response

Sample response

{
  "code" : 0,
  "msg" : "Received successfully"
}

Fields

Parameter	Type	Required	Example	Description
code	Number	Yes	0	The response code.
msg	String	No	Received successfully	The description.

Note

The system only checks if the code in your response is a number and does not validate its content. A request is considered successful if your endpoint returns an HTTP status code of 200. If the HTTP status code is not 200 or the request times out, the system retries the push.
If an error occurs on your endpoint, such as a processing failure, return an HTTP 5xx status code.

Retry mechanism

If a push notification fails, the system retries up to three times at 1-, 5-, and 10-minute intervals. If the third retry fails, no further attempts are made.