Skip to main content

Query transaction​

This API to is used to Query transaction information.

Request Body required
  • app_id int64 required

    This is a Zalopay-provided identifier specific to the merchant's service or application, established during the integration agreement for payment methods.

  • partner_order_id string required

    Merchant transaction ID sent to Zalopay system for disbursement execution (TXID of the disbursement transaction).

  • time int64 required

    Query request timestamp in milliseconds (Unix timestamp). Current timestamp in milliseconds based on current time.

  • mac string required

    Authentication information: mac = HMAC(hmac_algorihtm, mac key, hmacinput), see as below:
    - hmac_algorihtm: is a security method registered by Merchant with Zalopay, the default is HmacSHA256.
    - mac key: provided by Zalopay at registration.
    - hmac_input = app_id + | + partner_order_id + | + time.

    Please refer to secure data transmission for detailed information.

Responses

OK

Schema
  • return_code integer

    Status code.
    Please refer to status code for detailed information.

  • return_message string

    Description status code.

  • sub_return_code integer

    Status code detail.
    Please refer to sub status code for detailed information.

  • sub_return_message string

    Description status code detail.

  • data object
  • order_id string

    Zalopay disbursement transaction ID.

  • disbursement_type string

    Disbursement type: WALLET or BANK

  • m_u_id string

    User's identity in Zalopay.
    Note: only respond when verify by disbursement_type = "WALLET".

  • phone string

    Masked user's phone number Example: masked_user_phone: "****6938".
    Note: only respond when transfer by disbursement_type = "WALLET".

  • bank_code string

    Beneficiary bank code.
    Note: only respond when transfer by disbursement_type = "BANK".

  • account_no string

    Beneficiary account number.
    Note: only respond when transfer by disbursement_type = "BANK" and using account.

  • account_holder_name string

    Beneficiary account holder name.
    Note: only respond when transfer by disbursement_type = "BANK" and using account.

  • card_no string

    Beneficiary card number.
    Note: only respond when transfer by disbursement_type = "BANK" and using card.

  • card_holder_name string

    Beneficiary card holder name.
    Note: only respond when transfer by disbursement_type = "BANK" and using card.

  • status integer

    Disbursement execution status.
    - 1 SUCCESS : Successful transaction.
    - 2 FAIL : Failed transaction.
    - 3 PROCESSING: The transaction is in progress. The merchant must retry calling the Query Transaction API (/v2/disbursement/query-txn) periodically until reaching a final state.
    - 4 PENDING: Pending transactions, needs to be manually fixed by Zalopay internal teams.

  • amount int64

    Transaction disbursement amount.

  • partner_fee int64

    Partner fee

  • zlp_fee int64

    Zalopay fee.

  • server_time int64

    The initiation time of the transfer processing.

Loading...