Reverse a payment
Use the ReversePaymentRequestIntentBuilder
class to build an Intent to start an Activity that will guide a user through the payment reversal steps. Payment reversal can be processed as either a void or refund, depending on the requested amount, if any, and the time since the payment was taken. If an amount is specified, the request must be processed as a refund. If the amount is not specified, either a void or full payment refund will be processed based on several factors including how the payment was taken, how much time had passed since the payment was taken, and what amount was being requested. The result Intent contains a field, Intents.REVERSE_PAYMENT_RESULT, that will indicate if the payment was refunded or voided.
NOTE
ReversePayment is also used for voiding/canceling pre-auth payments.
Examples
Example—Full refund
You can build a reverse payment request (full amount) with a few lines of code.
val paymentId = payment.id // should be id from a payment/pre-auth
val context = this
val builder = ReversePaymentRequestIntentBuilder(paymentId)
val intent = builder.build(context)
Context context = this;
String paymentId = payment.getId(); // should be id from a payment/pre-auth
ReversePaymentRequestIntentBuilder builder = new ReversePaymentRequestIntentBuilder(paymentId);
Intent intent = builder.build(context);
The Intent can then be used to start the activity to process the reverse payment request.
Example—Partial refund
This is an example of a partial amount refund.
NOTE
A partial refund cannot be processed on a non-finalized payment, that is, a payment awaiting closeout.
val paymentId = payment.id // should be id from a payment/pre-auth
val context = this
val builder = ReversePaymentRequestIntentBuilder(paymentId)
builder.amount(500) // requesting a $5 partial refund
val intent = builder.build(context)
Context context = this;
String paymentId = payment.getId(); // should be id from a payment/pre-auth
ReversePaymentRequestIntentBuilder builder = new ReversePaymentRequestIntentBuilder(paymentId);
builder.amount(500L); // requesting a $5 partial refund
Intent intent = builder.build(context);
Processing results
when(intent.getStringExtra(Intents.EXTRA_REVERSE_PAYMENT_RESULT)) {
ReversePaymentResult.REFUNDED.name -> {
val paymentId = intent.getStringExtra(Intents.EXTRA_PAYMENT_ID)
val refund = intent.getParcelableExtra<Refund>(Intents.EXTRA_REFUND)
}
ReversePaymentResult.VOIDED.name -> {
val paymentId = intent.getStringExtra(Intents.EXTRA_PAYMENT_ID)
}
ReversePaymentResult.FAILED.name -> {
// request failed
intent.getStringExtra(Intents.EXTRA_FAILURE_MESSAGE)
}
}
public void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
String result = data.getStringExtra(Intents.EXTRA_REVERSE_PAYMENT_RESULT);
if (result.equals(ReversePaymentResult.REFUNDED.name())) {
String paymentId = data.getStringExtra(Intents.EXTRA_PAYMENT_ID);
Refund refund = data.getParcelableExtra(Intents.EXTRA_REFUND);
} else if (result.equals(ReversePaymentResult.VOIDED.name())) {
String paymentId = data.getStringExtra(Intents.EXTRA_PAYMENT_ID);
} else if (result.equals(ReversePaymentResult.FAILED.name())) {
String failureMessage = data.getStringExtra(Intents.EXTRA_FAILURE_MESSAGE);
}
}
Updated about 1 month ago