Direct API integration

The following test scenarios has to be done for the connection via API.

Before Go-Live please process the following tests if you connect front- and backend through our API.


Device Fingerprinting

Please ensure that the device fingerprinting script is executed correctly and that a device fingerprint token is transmitted.

Please contact your Ratepay representative for further assistance.

Operations

attention

Please also consider the following special features in the following test chains if they occur in your operational business:

  • Percentage and absolute discounts
  • Bonus points
  • Different shipping methods and costs
  • Additional costs such as trusted shops, handling costs, ...
  • Article bundles
  • Free articles

A: Partial cancellations

  1. Structure the order as follows:
    • 1 x Article A
    • 1 x Article B
    • Shipping costs
    • Voucher for discount (e.g. 10% or 5,00 €)
  2. Execute a partial cancellation for Article A.
  3. Cancel Article B, Shipping costs and the voucher.

B: Full cancellation

  1. Structure the order as follows:
    • 1 x Article A
    • 1 x Article B
    • Shipping costs
  2. Cancel the full order.

C: Partial deliveries

  1. Structure the order as follows:
    • 2 x Article A
    • 1 x Article B
    • Shipping costs
    • Voucher for discount (e.g. -10% or -5,00 €)
  2. Execute a partial delivery for the following items:
    • 1 x Article A
    • Shipping costs
    • Voucher for discount
  3. Execute a second delivery for the remaining articles.

D: Partial cancellation & remaining delivery

  1. The order should be structured as follows:
    • 1 x Article A
    • 1 x Article B
    • Shipping costs
    • Voucher for discount (e.g. -5,00 €)
  2. Perform a partial cancellation for article A.
  3. Execute a delivery for the remaining articles.

E: Partial returns

  1. The order should be structured as follows:
    • 2 x Article A
    • 1 x Article B
    • Shipping costs
    • Voucher for discount (e. g. -10%)
  2. Perform a delivery for all articles.
  3. Execute a partial return with the following articles:
    • 1 x Article A
  4. Finally return the remaining articles:
    • 1 x Article A
    • 1 x Article B
    • Shipping costs
    • Voucher for discount (e. g. -10%)

F: Full return

  1. The order should be structured as follows:
    • 2 x Article A
    • Shipping costs
    • Voucher for discount (e.g. -10% or -5,00 €)
  2. Perform a full delivery.
  3. Finally return all articles.

G: Discount before delivery

  1. The order should be structured as follows:
    • 1 x Article A
  2. Add a discount with a negative value, after placing the order.
  3. Execute a full delivery.

H: Add article (if contractually agreed)

  1. The order should be structured as follows:
    • 1 x Article A
    • 1 x Article B
    • Shipping costs
    • Voucher for discount (e.g. -10% or -5,00 €)
  2. Add another item in addition.
  3. Execute a full delivery.

I: Exchange article

  1. The order should be structured as follows:
    • 1 x Article A
    • 1 x Article B
    • Shipping costs
    • Voucher for discount (e. g. -10% or -5,00 €)
  2. Perform a full delivery
  3. Return Article A
  4. Add another item
    • 1 x Article C
  5. Perfom a delivery for Article C

J: Voucher value is higher than remaining receivable

  1. The order should be structured as follows:
    • 1 x Article A (e. g. 40,00 €)
    • 1 x Article B (e. g. 20,00 €)
    • 1 x Voucher with amount of e. g. -50,00 € (the value of the voucher should be below the order value)
  2. Make a delivery for the order.
  3. Execute a partial return for article B.
attention

In the last step, an error should occur, because the remaining amount is now negative.

Because here in this example a receivable value of -10,00 € arises, a return must be carried out for the entire order.


K: Discount & additional charge (if contractually agreed)

  1. The order should be structured as follows:
    • 3 x Article A
    • 3 x Article B
    • Shipping costs
  2. Add a discount, after placing the order.
  3. Perfom a partial delivery for the following articles:
    • 1 x Article A
    • 1 x Article B
    • Discount
  4. Add an additional debit / charge (e.g. fee)
  5. Perform a partial delivery for the remaining articles:
    • 2 x Article A
    • 2 x Article B
  6. Finally, add another discount.

L: Partial cancellation & partial return

  1. The order should be structured as follows:
    • 2 x Article A
    • 2 x Article B
    • 2 x Article C
    • Shipping costs
  2. Perform a partial delivery for 3 articles + shipping costs:
    • 2 x Article A
    • 1 x Article B
    • Shipping costs
  3. Perform a partial cancellation for Article C.
  4. Execute a partial return for the following articles:
    • 1 x Article A
    • 1 x Article B
  5. Make a partial delivery for the remaining articles:
    • 1 x Article B
    • 1 x Article C
  6. Complete a full return for the remaining three articles.

M: Rejection

Transmit orders with the following data to trigger specific result and reason codes. Please check whether these transactions were successfully rejected. Further check if the transactions do not appear in your subsequent systems.

Payment API 1.8

Result code Reason code First name Last name City
150 730 Buyer Ablehnung Testhausen
401 720 Payment Ablehnung Testhausen
401 721 Risk Ablehnung Testhausen
401 703 Generic* Ablehnung Testhausen

*: For a rejection with reason code 703: Request not successful you can freely select a technically valid first name.

Payment API 2.0

Email Decline Categories
buyer_identity@ratepay.com 422 - Buyer Identity
payment_attribute@ratepay.com 422 - Payment Attribute
risk_decision@ratepay.com 422 - Risk Decision
transaction_risk@ratepay.com 422 - Transaction Risk