Backoffice Integration Guide

Last updated:September 16, 2024

Venture forth with our Backoffice Integration guide, your key to mastering operations like refunds, reversals, captures, chargebacks, rebills, and credits. As a merchant, you’ll handle all transaction details, ensuring a smooth experience for your team. Navigate the backoffice payment landscape with our guide. Start today!

Initial payments via COPYandPAY or Server-to-Server allow backoffice operations.

Use cases

Reversal

The merchant voids the entire open amount of a pre-authorization. Depending on the payment method, the pre-authorization expires usually after a couple of days unless it is already captured or cancelled.

Here are the main reasons for cancelling a pre-authorized payment before it is settled:

  • Duplicate transactions: Errors in payment or delivery information, or delays in finalizing the purchase.
  • Customer change of mind: The customer decides to cancel the transaction.
  • Product unavailability: The purchased product or service becomes unavailable.

How it works

Pre-authorize payment

Send the pre-authorization request with the collected card data.

Reverse the payment

Send the reversal request to cancel the pre-authorization.

Transactions:
PA
PA
RV
RV

1. Pre-authorize payment

Initiate a server-to-server POST request with the required payment data. The payment details are verified with the issuer, and the funds are reserved. The response to a successful request is an id that should be stored and used in reversing the pre-authorization.


Brand:
Language:
curl https://eu-test.oppwa.com/v1/payments \
 -d "entityId=8ac7a4ca73522ba8017353bdfb9b0639" \
 -d "amount=92.00" \
 -d "currency=EUR" \
 -d "paymentBrand=VISA" \
 -d "paymentType=DB" \
 -d "card.number=4200000000000000" \
 -d "card.holder=Jane Jones" \
 -d "card.expiryMonth=05" \
 -d "card.expiryYear=2034" \
 -d "card.cvv=123" \
 -H "Authorization: Bearer OGFjN2E0Y2E3MzUyMmJhODAxNzM1M2JkZmJjODA2M2R8ejNxZnNycDNzbg=="

Try it Out

2. Reverse the payment

Initiate a server-to-server POST request over the pre-authorized payment. The payment is cancelled when you have authorized a payment but do not want to capture it, for example because an item is out of stock. The reserved funds are released to the shopper's account.

Sample request:


See also