2.2.4 Common push event

Path:/hc_sync/common

Method:POST

Content-Type:application/json

Response Content-Type:application/json

Description:

Endpoint for the common push event is prepared by the merchant and configure at merchant platform.

In all the push event, notify_type will use to identify the event type.

Merchant requires to identify the event type first in order to parse the response message according to the event type.

Merchant can still using the push event configure on 2.2.1 to 2.2.3，and the event data structure would be compatible with the event sent on 2.2.4.

Note ⚠️: Subsequent request body on this interface may add more fields; therefore, when using this interface, new fields that are not recognized need to be ignored to prevent errors

Card Open

Example Request:

{
  "notify_type": "OPEN_CARD",
  "card_type_id": "40000002",
  "email": "example@gmail.com",
  "mobile": "18301523750",
  "mobile_code": "86",
  "result": 1,
  "remark": "Remark",
  "mc_trade_no": "48d2741747a449361739208"
}

Request Parameter:

Recharge

Example Request:

{
  "notify_type": "RECHARGE",
  "card_id": "00003454323400000028888",
  "mc_trade_no": "48d2741747a4493223feb22",
  "result": "1"
}

Request Parameter:

Card Operation

Example Request:

{
  "notify_type": "OPERATION",
  "request_number": "48d2741747a449b2968a91e2523feb22",
  "operate_status": "1",
  "card_id": "00003454323400000028888"
}

Request Parameter:

Card Transaction

This event is not included the amount use in the transaction.

This event is mainly for notify the merchant for the new transaction have been product.

Merchant can use 2123_transaction_v2 endpoint to check for the transaction detail.

Example Request:

{
  "notify_type": "CONSUME",
  "card_id": "6654358889900018888"
}

Request Parameter:

Purchase Crypto Coin

Example Request:

{
  "notify_type": "BUY_COIN",
  "reason": "insufficient balance",
  "mc_trade_no": "48d2741747a4493223feb24",
  "tx_id": "20230413145817505390",
  "card_id": "6283244889900010107",
  "status": "2"
}

Request Parameter:

Cancel Card

Example Request:

{
  "notify_type": "CANCEL_CARD",
  "card_id": "20230413145817505390",
  "refund_amount": "100.00"
}

Request Parameter:

3ds Auth notify

Example Request:

{
  "notify_type": "AUTH_3DS",
  "auth_id": 283,
  "card_id": "15723682800000053333",
  "card_no": "103411******3333",
  "txn_currency": "EUR",
  "txn_amount": "1.00",
  "card_acceptor_merchant_name": "Amazon",
  "card_acceptor_location_country": 1,
  "auth_result": 2,
  "expired_time": 1706650873,
  "created_Time": 1699865734,
  "updated_Time": 1699865734,
  "app_card_id": "crd_y37fq5widtmubgavtthyoqpwia",
  "app3ds_auth_transaction_id": "aa61a6ca-a455-4740-9c56-ae83e4dd3798"
}

Request Parameter:

Opt Code Send

Example Request:

{
  "notify_type": "OPT_CODE",
  "card_id": "1085185460000094505",
  "code": "888666",
  "create_time": 1710412477
}

Request Parameter:

Card Config Change Notify

Example Request:

{
  "notify_type": "CARD_CONFIG_CHANGE",
  "card_type_id": "40000002",
  "modify_time": 1710412477
}

Request Parameter:

Expect API Response:

Example Response:

{
  "code": 1,
  "msg": "ok",
  "data": {}
}