Payment success

Updated at:
Copy as MD

After a user pays for a product, Alibaba Cloud Marketplace calls this Service Provider Interface (SPI) to send the instance information to the vendor.

  • If your service receives the request and returns a success response, Alibaba Cloud Marketplace marks the notification as successful and does not call the SPI again.

  • Do not block this interface. If a process is time-consuming, you can handle the business logic asynchronously. If a call fails, Alibaba Cloud Marketplace retries the call until it succeeds. The retry intervals are 1 m, 1 m, 1 m, 5 m, 10 m, 10 m, 10 m, 1 h, 1 h, 2 h, and 4 h. If all retries fail, the notification is marked as failed. You must then proactively retrieve the message by calling the OpenAPI operations DescribeFailedNotifications and ConfirmNotification.

  • This interface may be called multiple times. To handle repeated calls, ensure the idempotence of your interface using the `requestId` parameter.

Parameters

Parameter

Required

Type and scope

Description

action

true

String

Static field: orderPay

requestId

true

String

The request ID. Used for idempotence.

aliUid

true

String

The identity of the Alibaba Cloud user who purchased the product.

orderBizId

true

String

The business instance ID from Alibaba Cloud Marketplace.

orderId

true

String

The order ID from Alibaba Cloud Marketplace.

productCode

true

String

The product code from Alibaba Cloud Marketplace.

skuId

true

String

The SKU ID of the product.

token

true

String

SPI security token

Return value

HTTP/1.1 200 OK

Content-Type: application/json

{"success": true}

Call example

https://example.aliyundoc.com?action=orderPay&aliUid=12345678901234&orderBizId=12345&orderId=123456789&productCode=cmapi00001&requestId=469363e82a2847838bfcaeed436da272&skuId=yuncode215700000&token=302e51909f91a752b65a618c579ec881

Response example

{"success": true}