DPO Pay supports two types of reversals:

Action	Meaning
Void	Cancel an authorization or same-day sale before settlement
Refund	Return funds after settlement (full or partial)/call

📘
Always run a Status Lookup first to confirm whether the transaction has settled.

Endpoint

POST https://secure.3gdirectpay.com/API/v6/

Headers:

Content-Type:application/xml; charset=utf-8
Accept:application/xml

Required Fields

Field	Description
`CompanyToken`	Your merchant token
`Request`	`refundToken` or `cancelToke`
`TransactionToken`	Transaction token
`refundAmount`	Optional — send only for partial refunds
`refundDetails`	Refund description or reason.
`refundRef`	Refund reference.
`refundApproval`	If it is sent, the refund will be verified by an inspector.

Minimum: CompanyToken, Request, and TransactionToken.

Example — Partial Refund

<?xml version="1.0" encoding="utf-8"?>
<API3G>
  <Request>refundToken</Request>
  <CompanyToken>8D3DA73D-9D7F-4E09-96D4-3D44E7A83EA3</CompanyToken>
  <TransactionToken>705F5049-5B38-49AB-895E-B6EE499AA3F0</TransactionToken>
  <refundAmount>1.2</refundAmount>
  <refundDetails>Item out of stock</refundDetails>
</API3G>

Example Response

<?xml version="1.0" encoding="utf-8"?>
<API3G>
    <Result>000</Result>
    <ResultExplanation>Refund successful</ResultExplanation>
</API3G>

Example — Void (Cancel)

<?xml version="1.0" encoding="utf-8"?>
<API3G>
  <CompanyToken>8D3DA73D-9D7F-4E09-96D4-3D44E7A83EA3</CompanyToken>
  <Request>cancelToken</Request>
  <TransactionToken>CDE7067F-953D-475D-B3AD-9E412E4C4185</TransactionToken>
</API3G>

Example response

<?xml version="1.0" encoding="utf-8"?>
<API3G>
    <Result>000</Result>
    <ResultExplanation>Token been updated to status cancelled</ResultExplanation>
</API3G>

Error Response

<?xml version="1.0" encoding="utf-8"?>
<API3G>
    <Result>999</Result>
    <ResultExplanation>Cant modify token status due to current status: Paid</ResultExplanation>
</API3G>

▶️ Test in Postman

Common Codes

Code	Action
`000`	Token been updated to status cancelled
`999`	Custom error message
`804`	Error in XML
`950`	Request missing transaction level mandatory fields

See Verify Token Codes & Gateway Response Codes for full status tables.

Business Rules

Void = before settlement (same business day)
Refund = after settlement
Partial refunds supported (until full value reversed)
Currency must match the original transaction

Flow

sequenceDiagram
  participant M as Merchant
  participant D as DPO API

  M->>D: refund/void XML request
  D-->>M: Result = 000 or error
  M->>D: (Optional) verifyToken
  M->>M: Update order & finance logs

Implementation Tips

Prefer TransRef when possible
Always log: TransRef, Amount, Result, Reason
Handle retries gracefully — avoid double-refunds
Show friendly UI messages, not raw codes

Quick Developer Actions

<HTMLBlock>
<div class="dpo-cta" role="group">
  <a class="dpo-btn dpo-primary" href="../transaction-status-lookup">Verify Transaction</a>
  <a class="dpo-btn dpo-outline" href="../reference/gateway-response-codes-v6">Response Codes</a>
</div>
</HTMLBlock>