AlipayHKAlipayHKDOCS

How can we help?

Movie Ticket

{"content":{"bizType":"NOTIFICATION","endpoint":"/api/open/alipay/v1/ipass/pass/manage/createPass","hideEndpoint":true,"description":"

This page discuss the extended information for queuing up scenarios, please also check the base API.

Order Status

Notification can start from any status below and status can be skipped if necessary, but not in reverse.

Order Status

Description

Notification Logic

TICKETED

When the ticket is issued.

Issue ticket in Card Wallet.

Performance notification will be shown 2 hours before start_time

REFUNDED

When the order is refunded.

Hide performance notification.

Ticket will disappear.

USED

When the ticket is used.

Hide performance notification.

Ticket status change to USED.


Below is the extra fields of this scenario, please also check the base API fields.

","descriptionLake":"

This page discuss the extended information for queuing up scenarios, please also check the base API.

Order Status


","result":[],"moreCodes":[],"request":[{"name":"tradeNo","description":"

The transaction number provided by Alipay.

","descriptionLake":"

The transaction number provided by Alipay.

","editType":"string","type":"string","warning":"","warningLake":""},{"name":"amount","description":"

The original amount of this ticket.

","descriptionLake":"

The original amount of this ticket.

","editType":"object","type":"object","warning":"","warningLake":"","kvs":[{"name":"value","description":"

Value in cents.

","descriptionLake":"

Value in cents.

","editType":"string","type":"string","warning":"","warningLake":"","required":true},{"name":"currency","description":"

A 3-letter ISO 4217 currency code, i.e. HKD

","descriptionLake":"

A 3-letter ISO 4217 currency code, i.e. HKD

","editType":"string","type":"string","warning":"","warningLake":"","required":true}]},{"name":"payAmount","description":"

The actual amount user paid.

","descriptionLake":"

The actual amount user paid.

","editType":"object","type":"object","warning":"","warningLake":"","kvs":[{"name":"value","description":"

Value in cents.

","descriptionLake":"

Value in cents.

","editType":"string","type":"string","warning":"","warningLake":"","required":true},{"name":"currency","description":"

A 3-letter ISO 4217 currency code, i.e. HKD

","descriptionLake":"

A 3-letter ISO 4217 currency code, i.e. HKD

","editType":"string","type":"string","warning":"","warningLake":"","required":true}]},{"name":"extInfo","description":"","descriptionLake":"","editType":"object","type":"object","warning":"","warningLake":"","required":true,"kvs":[{"name":"merchant_bill_id","description":"

Merchant's order ID.

","descriptionLake":"

Merchant's order ID.

","editType":"string","type":"string","warning":"","warningLake":""},{"name":"merchant_bill_detail","description":"

An URL redirects to the order detail page, starts with allpayhk://.

","descriptionLake":"

An URL redirects to the order detail page, starts with allpayhk://.

","editType":"string","type":"string","warning":"","warningLake":""},{"name":"code_info","description":"

An object controls the display code value.

","descriptionLake":"

An object controls the display code value.

","editType":"object","type":"object","warning":"

REQUIRED when status is ​TICKETED.

","warningLake":"

when status is TICKETED.

","kvs":[{"name":"code_value","description":"

Value of the display code.

","descriptionLake":"

Value of the display code.

","editType":"string","type":"string","warning":"","warningLake":"","required":true},{"name":"code_msg","description":"

Message of the display code.

","descriptionLake":"

Message of the display code.

","editType":"string","type":"string","warning":"","warningLake":"","required":true}]},{"name":"template_code","description":"

A template code ID provided by AlipayHK.

","descriptionLake":"

A template code ID provided by AlipayHK.

","editType":"string","type":"string","warning":"

REQUIRED when status is TICKETED.

","warningLake":"

when status is TICKETED.

"},{"name":"available_time","description":"

Notification / Ticket display start datetime to the user in milliseconds.

","descriptionLake":"

Notification / Ticket display start datetime to the user in milliseconds.

","editType":"number","type":"number","warning":"

REQUIRED when status is TICKETED.

","warningLake":"

when status is TICKETED.

"},{"name":"expired_time","description":"

Notification / Ticket display end datetime of this ticket in milliseconds.

","descriptionLake":"

Notification / Ticket display end datetime of this ticket in milliseconds.

","editType":"number","type":"number","warning":"

REQUIRED when status is TICKETED.

","warningLake":"

when status is TICKETED.

"},{"name":"start_time","description":"

Start datetime of this event in milliseconds.

","descriptionLake":"

Start datetime of this event in milliseconds.

","editType":"number","type":"number","warning":"

REQUIRED when status is TICKETED.

","warningLake":"

when status is TICKETED.

"},{"name":"end_time","description":"

End datetime of this event in milliseconds.

","descriptionLake":"

End datetime of this event in milliseconds.

","editType":"number","type":"number","warning":"

REQUIRED when status is TICKETED.

","warningLake":"

when status is TICKETED.

"},{"name":"available_times","description":"

Available usage of this ticket, i.e. ​​\"1\"​​.

","descriptionLake":"

Available usage of this ticket, i.e. "1".

","editType":"string","type":"string","warning":"","warningLake":""},{"name":"multiLang","description":"

An object providing business dedicated display information of different locale.

  • zh_HK: Traditional Chinese
  • en_US: English
","descriptionLake":"

An object providing business dedicated display information of different locale.

  • zh_HK: Traditional Chinese
  • en_US: English
","editType":"object","type":"object","warning":"","warningLake":"","required":true,"kvs":[{"name":"cinema_name","description":"

Cinema name of this ticket.

","descriptionLake":"

Cinema name of this ticket.

","editType":"string","type":"string","warning":"","warningLake":"","maxLength":64},{"name":"cinema_house","description":"

Cinema house of this ticket.

","descriptionLake":"

Cinema house of this ticket.

","editType":"string","type":"string","warning":"","warningLake":"","required":true,"maxLength":64},{"name":"address","description":"

Address of the event.

","descriptionLake":"

Address of the event.

","editType":"string","type":"string","warning":"

REQUIRED when status is TICKETED.

","warningLake":"

when status is TICKETED.

","required":true,"maxLength":64},{"name":"movie_attributes","description":"

List of information tags of the movie.

","descriptionLake":"

List of information tags of the movie.

","editType":"string","type":"Array","warning":"","warningLake":"","required":true},{"name":"movie_seats","description":"

List of movie seats of this ticket.

","descriptionLake":"

List of movie seats of this ticket.

","editType":"string","type":"Array","warning":"","warningLake":""},{"name":"ticket_info_list","description":"","descriptionLake":"","editType":"object","type":"object","warning":"","warningLake":"","required":true,"kvs":[{"name":"ticketLevel","description":"

Service level of the tickets.

","descriptionLake":"

Service level of the tickets.

","editType":"string","type":"string","warning":"","warningLake":"","required":true},{"name":"count","description":"

Number of tickets of this service level.

","descriptionLake":"

Number of tickets of this service level.

","editType":"string","type":"string","warning":"","warningLake":"","required":true}]},{"name":"platform_name","description":"

Name of the platform / agency.

","descriptionLake":"

Name of the platform / agency.

","editType":"string","type":"string","warning":"","warningLake":"","maxLength":64},{"name":"platform_logo","description":"

An URL redirects to the logo of the platform / agency.

","descriptionLake":"

An URL redirects to the logo of the platform / agency.

","editType":"string","type":"string","range":"<100 KB","warning":"","warningLake":"","maxLength":256}]}]}],"response":[],"examples":[{"scene":[],"request":"{ \"amount\": { \"value\": \"10000\", \"currency\": \"HKD\" }, \"payAmount\": { \"value\": \"2000\", \"currency\": \"HKD\" }, \"tradeNo\": \"2123094382159431592739568123\", \"extInfo\": { \"merchant_bill_detail\": \"alipayhk://platformapi/startapp?appId=2102000032500019\", \"merchant_bill_id\": \"P2046\", \"codeInfo\": { \"code_msg\": \"codeInfo\", \"code_value\": \"codeInfo\" }, \"template_code\": \"22025030300135606000000015385502\", \"available_time\": 1740998266927, \"expired_time\": 1741001866927, \"start_time\": 1740998266927, \"end_time\": 1741001866927, \"available_times\": 1, \"multiLang\": { \"zh_HK\": { \"cinema_name\": \"AlipayHK 影院\", \"cinema_house\": \"1 號院\", \"address\": \"香港銅鑼灣勿地臣街 1 號\", \"movie_attributes\": [ \"2D Atmos D-BOX\", \"120分鐘\", \"動作、科幻\", \"IIA\" ], \"movie_seats\": [ \"F20\", \"F21\" ], \"ticket_info_list\": [ { \"ticketLevel\": \"成人票\", \"count\": \"1\" } ], \"platform_name\": \"AlipayHK\", \"platform_logo\": \"https://mdn.alipayobjects.com/huamei_xfceij/afts/img/A*Wbi4SpWwX_IAAAAAAAAAAAAADgeDAQ/original\" }, \"en_US\": { \"cinema_name\": \"AlipayHK Cinema\", \"cinema_house\": \"House 1\", \"address\": \"1 Matheson Street, Causeway Bay, Hong Kong\", \"movie_attributes\": [ \"2D Atmos D-BOX\", \"120 Mins\", \"Action, Sci-Fi\", \"IIA\" ], \"movie_seats\": [ \"F20\", \"F21\" ], \"ticket_info_list\": [ { \"ticketLevel\": \"Adult\", \"count\": \"1\" } ], \"platform_name\": \"AlipayHK\", \"platform_logo\": \"https://mdn.alipayobjects.com/huamei_xfceij/afts/img/A*Wbi4SpWwX_IAAAAAAAAAAAAADgeDAQ/original\" } } }}"}],"exampleResponse":[]},"sceneConfig":[{"name":"APP","items":[{"icon":"https://gw.alipayobjects.com/mdn/rms_b3f2c2/afts/img/A*g-x4R5biJnsAAAAAAAAAAAAAARQnAQ","name":"ALIPAY","width":70,"text":""},{"icon":"https://gw.alipayobjects.com/mdn/rms_b3f2c2/afts/img/A*oWi6R65CbmgAAAAAAAAAAAAAARQnAQ","name":"ALIPAY_HK","width":70,"text":""},{"icon":"https://gw.alipayobjects.com/mdn/rms_b3f2c2/afts/img/A*BGsoRLcqPFAAAAAAAAAAAAAAARQnAQ","name":"GCASH","width":70,"text":""},{"icon":"https://gw.alipayobjects.com/mdn/rms_b3f2c2/afts/img/A*3gswS6s147sAAAAAAAAAAAAAARQnAQ","name":"DANA","width":70,"text":""},{"icon":"https://gw.alipayobjects.com/mdn/rms_b3f2c2/afts/img/A*aN3iTZOdEhgAAAAAAAAAAAAAARQnAQ","name":"KAKAO_PAY","width":70,"text":""}]},{"name":"CLIENT","direction":"row","items":[{"name":"APP","icon":"https://gw.alipayobjects.com/mdn/rms_b3f2c2/afts/img/A*sHjISq1PKn8AAAAAAAAAAAAAARQnAQ","width":40},{"name":"H5","icon":"https://gw.alipayobjects.com/mdn/rms_b3f2c2/afts/img/A*cOz7T50g1I0AAAAAAAAAAAAAARQnAQ","width":40},{"name":"DESKTOP","icon":"https://gw.alipayobjects.com/mdn/rms_b3f2c2/afts/img/A*NKaIRq-KfQYAAAAAAAAAAAAAARQnAQ","width":40}]},{"name":"MERCHANT","items":[{"name":"INST","text":"机构商户"},{"name":"DIRECT","text":"直联商户"}]},{"name":"GRANT_TYPE","items":[{"name":"AUTHORIZATION_CODE","text":"AUTHORIZATION_CODE"},{"name":"REFRESH_TOKEN","text":"REFRESH_TOKEN"}]},{"name":"CREATE_MEMBERSHIP_CARD","items":[{"name":"WITH_USER_INFO","text":"With user information"},{"name":"WITHOUT_USER_INFO","text":"Without user information"}]},{"name":"COLLECT_PMS_INFORMATION","items":[{"name":"MERCHANT_PMS","text":"MERCHANT_PMS"},{"name":"IPAY_TRADE_NO","text":"IPAY_TRADE_NO"}]},{"name":"Card Type","items":[{"name":"COUPON","text":"COUPON"},{"name":"TICKET","text":"TICKET"}]},{"name":"Ticket Type","items":[{"name":"PASS","text":"PASS"},{"name":"MOVIE","text":"MOVIE"},{"name":"AIR TICKET","text":"AIR TICKET"},{"name":"TRAIN TICKET","text":"TRAIN TICKET"},{"name":"BUS TICKET","text":"BUS TICKET"},{"name":"SHIP TICKET","text":"SHIP TICKET"}]},{"name":"Display Code Type","items":[{"name":"BARCODE","text":"BARCODE"},{"name":"QR CODE","text":"QR CODE"},{"name":"PROMO CODE","text":"PROMO CODE"},{"name":"NONE","text":"NONE"}]},{"name":"Card Status","items":[{"name":"USED","text":"USED"},{"name":"CLOSED","text":"CLOSED"},{"name":"UPDATE","text":"UPDATE"},{"name":"REFUND","text":"REFUND"}]},{"name":"內容入庫","items":[{"name":"Catering (BRAND)","text":"Catering (BRAND)"},{"name":"Catering (STORE)","text":"Catering (STORE)"},{"name":"MOVIE","text":"MOVIE"},{"name":"E-Commerce (STORE)","text":"E-Commerce (STORE)"},{"name":"E-Commerce (SKU)","text":"E-Commerce (SKU)"}]}]}