Refund

Overview

The refund method returns funds to a customer's payment method.

Request Fields

Field	Type	Required	Description
merchantRefundId	String	Yes	Your refund reference
connectorTransactionId	String	Yes	Transaction ID
refundAmount	Money	No	Amount to refund
reason	String	No	Refund reason

Response Fields

Field	Type	Description
status	RefundStatus	PENDING, SUCCEEDED
connectorRefundId	String	Refund ID

Example

Map<String, Object> request = new HashMap<>();
request.put("merchantRefundId", "refund_001");
request.put("connectorTransactionId", "pi_xxx");
request.put("refundAmount", Map.of("minorAmount", 1000, "currency", "USD"));

Map<String, Object> response = paymentClient.refund(request);