Skip to main content

📄 Guide

Whether you are dealing with a transaction that has not landed, a KYC case stuck in review, or a cardholder reporting a suspicious charge, DCS gives you one clear escalation path to get the case to the right team quickly. This page explains when to escalate, who to escalate to, and what to bring, so the investigation can be done in a single round. As a licensed issuer, DCS provides post-launch support to partners through a dedicated Customer Success team. Anything involving the issuing channel (the card scheme), clearing or disputes is taken up with the channel by DCS on your behalf, so you never need to contact the scheme yourself.

How to escalate

Submit your case through the Customer Success contact channel agreed with DCS (your dedicated Customer Success contact, the shared mailbox, or the project chat group). To help the DCS team pinpoint the case faster, bring as much of the following as you can:
for transaction cases, transactionId plus the last 4 digits of the card number is usually enough to locate the record; for KYC cases, attach customerId and kycTicketId; for API errors, attach the full request and response payload, including code and messageDetail from the standard response envelope.

When to escalate

Escalate to the DCS Customer Success team promptly in the following situations:
  • A refund has not arrived for a long time: the merchant has refunded, but the cardholder’s account still shows nothing after a long period (as a guide, more than 30 business days).
  • A KYC application is stuck: the KYC ticket has been sitting under review well beyond the committed review window (about 2–3 business days). Before escalating, confirm that the documents submitted are legible and that the front, back and selfie are labeled correctly (see About KYC Documents).
  • A cardholder reports a suspicious or unauthorised transaction: the cardholder says a charge was not made by them, and suspects fraud or an incorrect debit.
  • You need a suspicious merchant blocked: you have identified a risky merchant and want it blocked.
  • An API keeps returning errors and you cannot pinpoint the cause: you have already checked your authentication configuration, the error code and the request payload without resolving it.

Handling disputes and fraud

When a cardholder needs to raise a transaction dispute or chargeback over an unauthorised transaction, an incorrect debit, or a merchant that failed to deliver:
  • Today: submit the case through the Customer Success contact channel above, and DCS will raise the dispute with the scheme and follow the outcome through on your behalf. Provide the transactionId, the last 4 digits of the card number, the dispute reason and whatever evidence you have (order screenshots, correspondence with the merchant, and so on).
  • Fraud containment: where fraud is confirmed, freeze the affected card at the same time through the freeze endpoint (POST /open-api/card/v1/freeze with freeze=true), or cancel it outright, to prevent further loss.
disputes and fraud are currently submitted and followed up with the help of the DCS Customer Success contact channel. Self-service endpoints for raising a dispute, uploading evidence and checking dispute progress are on the roadmap (see Disputes How-to); this page will be updated to describe the self-service flow once they are live.

Where to find the reference codes for troubleshooting

Before escalating, check the following data dictionaries: many cases can be diagnosed from them without help.

Next steps

Before escalating, it is worth going through the Post-Go-Live FAQ: many common issues (mobile wallet provisioning failures, delayed refunds, pending applications and so on) already come with self-service guidance.