Skip to main content

Chargeback Notification

Overview​

In the event of a chargeback, Botim Money sends the relevant chargeback information to the merchant via a data stream. The merchant system must receive, process, and respond to this notification according to the API specifications.

Note

  • Duplicate Notifications: The same notification may be sent multiple times. The merchant system must be able to handle duplicate messages correctly and idempotently.
  • Retry Mechanism: If Botim Money does not receive a valid or timely response from the merchant, it will consider the notification failed and retry delivery. The default retry schedule is up to 7 attempts at the following intervals (in minutes): 2, 10, 10, 60, 120, 360, 900. However, successful delivery is not guaranteed.
  • Order Status Uncertainty: If the order status is unclear or no notification is received, merchants are advised to actively query the order status using the appropriate API.

Request​

Http Header​

  • Content-Type String Required

    • The media type. Required for operations with a request body. The value is application/<format>, where format is json.
    • Example value: application/json

  • sign String Required

    When Botim Money sends a notification, Botim Money will use its own private key to sign the message, and the merchant uses Botim Money's public key to verify the signature. If the verification is passed, it proves that the notification was sent by Botim Money and not faked by others.

Http Body​

  • notify_timestamp Timestamp Required

    • The timestamp when Botim Money sent the notification.
    • Example value: 1586849271877

  • notify_id String Required

    • The unique identification number of this notification within the Botim Money system.
    • Example value: 202004140007474501

  • acquireChargeback Object

    Attributes

    • chargebackTime Timestamp(3) Required

      Timestamp indicating when the chargeback was initiated.

      • Example value: 1581493898000

    • merchantOrderNo String(64) Required

      Unique identifier for the merchant's original order.

      • Example value: S10000

    • orderNo String(32) Required

      Unique identifier for the Botim Money transaction order.

      • Example value: O1000

    • payAmount Money Required

      Total amount originally paid in the transaction.

    • chargebackAmount Money Required

      Amount being reversed or refunded due to the chargeback.

    • caseType String(200) Required

      Classification of the chargeback case, such as fraud, dispute, or duplicate transaction.

    • partnerId String(200) Required

      Identifier for the partner or merchant associated with the transaction.

      • Example value: 200000003232

Response​

Please reply success after receiving the notification, otherwise Botim Money will send the notification repeatedly for the same order.

Http Header​

  • Content-Type String Required

    • The media type. Required for operations with a request body. The value is application/<format>, where format is json.
    • Example value: application/json

Http Body​

  • response String Required

    Example value: Success

Response Sample​

Http Header
{
    "Content-Type": "application/json; charset=UTF-8"
}

Http Body
{
    "response": "SUCCESS"
}