Skip to content
Physical Prizes

Submit Prize Recipient Details

Submits or changes the fulfillment method and recipient details for a physical prize: for shipping, submit the recipient, phone, and address; for pickup, submit a contact email and pickup location. Available methods and pickup locations are delivery_types and addresses from GET /rewards/reward_prize_info.

You can submit when either condition is met:

  • status is 8 or 10, and deliver_status is 0 or 8.
  • status is 8 or 12, no tracking number deliver_order exists, and deliver_status is 0, 8, 9, or 11.

Once a tracking number is generated, the address is locked and cannot be changed. After success, call GET /rewards/reward_prize_info again to refresh the status. On failure, show message.

POSThttps://api.lbkrs.com/rewards/update_express_info

Request body application/json

record_idintegerrequired

Prize record ID

express_infoobjectrequired

Fulfillment method and recipient details for a physical prize. For shipping, fill in the recipient, phone, and address fields; for pickup, fill in email and pickup_info

Child attributes
delivery_typeintegerrequired

Fulfillment method:

  • 1 - Pickup
  • 2 - Shipping
Values
1
2
addresseestring

Recipient name (shipping)

country_codestring

Country or region calling code of the recipient phone (shipping)

phonestring

Recipient phone number without the calling code (shipping)

provincestring

Province or state (shipping). Use sg for Singapore and mo for Macao

citystring

City (shipping)

districtstring

District (shipping)

shipping_addressstring

Street address (shipping)

postcodestring

Postal code (shipping)

emailstring

Contact email (pickup)

pickup_infoobject

Pickup location, one of the addresses in the prize details (pickup)

Child attributes
briefstring

Location short name

detailstring

Location details

Responses

HTTP 200The request succeeded. The response body contains the result of the “Submit prize recipient details” operation.
codeintegerrequired

Business status code, 0 indicates success

messagestringrequired

Human-readable result or error message.

Whale Docs