Ratepay API Payment-Change Logic
Manage customer requirements and customer complaints with ease!
The gateway <operation>PAYMENT_CHANGE is used to manage
    shopping cart modifications
    (partial) cancellations
    (partial) returns
    goodwill refunds
Learn how to use the <operation> element correctly. On the next pages we are going to modify one single transaction multiple times.

Purchase Order

Every transaction starts with a purchase.
1
<operation>PAYMENT_REQUEST</operation>
Copied!

Assumption

Let's imagine a shopper bought three items. One item has a discount. Then there are some shipping fees and our customer redeemed a voucher. The shopping basket amount is 305 Euros in total.
Try to reconstruct the total basket value.

XML request

PAYMENT_REQUEST.xml
1
<shopping-basket amount="305" currency="EUR">
2
<items>
3
<item article-number="A" quantity="2" tax-rate="19.00" unit-price-gross="100" discount="-10" description-addition="Rot">Bed Linen</item>
4
<item article-number="B" quantity="2" tax-rate="19.00" unit-price-gross="40" description-addition="100x200">Towel</item>
5
<item article-number="D" quantity="2" tax-rate="19.00" unit-price-gross="25">Scarf</item>
6
</items>
7
<discount unit-price-gross="-10" tax-rate="19.00">Voucher</discount>
8
<shipping unit-price-gross="5" tax-rate="19.00">UPS Standard</shipping>
9
</shopping-basket>
Copied!

Result

#
Price
🛒
<item>
A
90 €
2
<item>
B
40 €
2
<item>
D
25 €
2
<discount>
-10 €
-10 €
<shipping>
5 €
5 €
Last modified 2yr ago
Copy link