Deposit Cancellation

Method

CancelDepositClosedLoop


Description

The Cancel Deposit Transaction feature allows the cancellation of a previously confirmed deposit operation.

When the request is submitted within the allowed timeframe, the deposit transaction is canceled and the credited amount is reversed to the user’s account.

To request a deposit cancellation, it is mandatory to provide the cancellation reason code, according to the defined reason catalog, indicating the reason why the operation is being canceled.


Business Rules

  • A deposit cancellation may be requested within 10 minutes after the transaction confirmation.
  • Requests submitted after this timeframe will not be processed.
  • In such cases, the API will return the following message:

"The deadline to request the cancellation has expired. Please contact support."


Cancellation Reason Catalog

CodeReasonOperation TypeDescription / Example
C01User errorCash-In / Cash-Out / PaymentIncorrect amount, wrong account, or duplicated operation.
C02Insufficient fundsCash-Out / PaymentBalance lower than the requested amount.
C03Limits exceededCash-Out / PaymentDaily, monthly, or per-operation limit exceeded.
C04Duplicate operationAllSame amount, destination, and reference within a short time window.
C05Timeout / Session expiredAllUser did not complete the operation within the allowed time.
C06System technical failureAllInternal error, service outage, or no API response.
C07Fraud detected / AML blockAllSuspicious pattern, watchlist match, PEP, or KYC alert.
C08Cancellation requested by userAllUser voluntarily cancels before confirmation.
C09Merchant does not accept paymentPaymentMerchant rejection (e.g. expired QR code or mismatched amount).
C10Blocked or inactive accountAllAccount suspended or pending KYC.
C11OTP / Biometric validation errorAllIncorrect OTP after 3 attempts or biometric validation failure.
C12Unauthorized deviceAllOperation performed from an unregistered device.
C13Chargeback reversalPaymentCustomer disputes a card payment after execution.
C14Support-initiated cancellationAllOperation canceled by a support agent after a validated request.
C15Reconciliation failureCash-InDeposit received but not reconciled within 48 hours.

JSON Request

{
  "Method": "CancelDepositClosedLoop",
  "BusinessUnitId": 30420,
  "PartnerId": 10409,
  "MerchantAccountKey": "378320-014700-0146333-1",
  "OriginalIdentifier": "8974841514514514sd",
  "Identifier": "8974841514514514sd",
  "Reason": "C01"
}

JSON Response
{
  "Success": true,
  "Message": "generated successfully"
}