Refund and reverse

Refunds & Reversals (CREDITVOID)#

CREDITVOID handles both reversals (cancel an AUTH hold) and refunds (return settled funds). Full and partial refunds are supported. Multiple partial refunds are allowed.

POST https://{PAYMENT_URL}/post

Parameter	Description	Required
`action`	`CREDITVOID`	Yes
`client_key`	Your account key	Yes
`trans_id`	Original CentaPay transaction ID	Yes
`amount`	Partial refund amount. Omit for full refund.	No
`hash`	Formula 2	Yes

Synchronous response returns result: ACCEPTED. Final result delivered via callback:

Callback `status`	Meaning
`REFUND` or `REVERSAL`	Full refund / full reversal completed
`SETTLED`	Partial refund applied (original transaction remains settled)

curl -X POST https://{PAYMENT_URL}/post \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "action=CREDITVOID" \
  -d "client_key={CLIENT_KEY}" \
  -d "trans_id={TRANS_ID}" \
  -d "amount=25.00" \
  -d "hash={FORMULA_2_HASH}"

// Formula 2: md5(strtoupper(strrev(email).PASSWORD.trans_id.strrev(first6+last4)))
$hash = md5(strtoupper(strrev($email).PASSWORD.$transId.strrev($cardPart)));
$params = [
  'action' => 'CREDITVOID',
  'client_key' => CLIENT_KEY,
  'trans_id' => $transId,
  'amount' => '25.00',
  'hash' => $hash,
];

Same-Day Void (VOID)#

Cancel a transaction performed the same financial day. Only allowed for SETTLED transactions from SALE, CAPTURE, or RECURRING_SALE operations. Unlike CREDITVOID, VOID does not process a refund — it cancels the transaction entirely.

Parameter	Description	Required
`action`	`VOID`	Yes
`client_key`	Your account key	Yes
`trans_id`	Transaction ID to void	Yes
`hash`	Formula 2	Yes

ℹ️

VOID vs CREDITVOID: Use VOID for same-day cancellations (no funds movement). Use CREDITVOID for refunds after settlement day or to reverse an AUTH hold.