Nothing Found

DeveloperDocumentations for the Ratepay APIs and services.

DeveloperDocumentations for the Ratepay APIs and services.

Before you start

What is Ratepay

Payment methods

Integration options

Payment integration

Direct API integration

Payment API 2.0

Payment API 1.8

Introduction

How to integrate Ratepay

The Ratepay Gateway Operations

Developer tools

Quick Start Guide

Example Responses

100 - Internal server error

1000 - Technical error

101 - Datebase access error

102 - Risk Management processing error.

120 - Authentification failed - Merchant or product not active

121 - <OPERATION>* request must contain credential.

200 - Validation failed

2000 - Validation failed

2001 - Different delivery address for current product not allowed

2002 - B2b not allowed for current product

2003 - Date of Birth invalid

2004 - Due date parameter(s) not valid

2005 - Shopping basket amount too low for current product

2006 - Shopping basket amount too high for current product

201 - Operation missing - Please check request

202 - Illegal operation type - Please check request

203 - Validation of business rules failed

206 - PAYMENT_INIT request may not contain transaction-id

208 - PAYMENT_INIT request may not contain content element

209 - <OPERATION>* request must contain content element

210 - <OPERATION>* content must contain shopping basket

2100 - Billing address not valid

2101 - Delivery address not valid

211 - PAYMENT_QUERY content must contain customer if classification is requested

2110 - IBAN not valid

2111 - Bank account conversion service not present and no iban available

2112 - BIC not valid

2114 - Validation failed - Customer parameter vat-id is mandatory for B2B request

2115 - Validation failed - vat-id not valid for billing address

2116 - Validation failed - item discount not allowed for current api version

2117 - Validation failed - discount not allowed for current api version

2118 - Validation failed - shipping costs not allowed for current api version

2119 - Basket amount does not match sum of all basket items

212 - PAYMENT_REQUEST content must contain payment

2120 - Request must contain at least one item in shopping basket

2121 - Bank account reference unknown

213 - PAYMENT_REQUEST content must contain payment method

214 - <OPERATION>* request must contain operation subtype

216 - <OPERATION>* content must contain customer data

217 - Installment details mandatory for payment method

219 - Installment amount mandatory for payment method

220 - Customer parameter contacts is mandatory for request

221 - Customer parameter email is mandatory for request

222 - Customer parameter first name is mandatory for request

223 - Customer parameter last name is mandatory for request

224 - Customer parameter addresses is mandatory for request

225 - Customer parameter customer-allow-credit-inquiry is mandatory for request

226 - Customer parameter gender is mandatory for request

227 - Customer parameter date-of-birth is mandatory for B2C request

229 - Amount mandatory for payment method

230 - Bank account data mandatory

2300 - Request basket not valid {message} unknown item

2301 - Payment change credit is not allowed before delivery

2302 - Sum of delivered items is negative

2303 - Equal items found in basket

2304 - Payment change credit must not contain special shipping item

2305 - Payment change credit has to contain only new credit/debit item(s)

2306 - Order (sum of open and delivered amounts) must not be negative

2307 - Item quantity from request does not match corresponding item quantity in current_basket-table

2308 - One or more mandatory item attributes are missing

231 - Debit pay type is allowed for INSTALLMENT only

2310 - Test in production not allowed

2311 - The order is blocked for further changes

232 - CALCULATION_REQUEST request must contain credential

233 - CALCULATION_REQUEST request must contain content element

234 - CALCULATION_REQUEST request must contain operation subtype

235 - CALCULATION_REQUEST request must contain installment-calculation element

236 - CALCULATION_REQUEST request for subtype 'calculation-by-rate' must contain calculation-rate

237 - CALCULATION_REQUEST request for subtype 'calculation-by-time' must contain calculation-time

238 - CONFIGURATION_REQUEST request must contain credential

239 - CONFIGURATION_REQUEST request must not contain content element

240 - Debit pay type is mandatory for payment method INSTALLMENT

241 - <OPERATION>* request must contain transaction-id

242 - No more than 10 numerical characters allowed for bank-account-number

243 - Required 8 numerical characters for bank-code

250 - Billing country not allowed

251 - Delivery country not allowed

252 - Country Code not valid

260 - Shop-id in external block is mandatory for this product / Request must not contain shop-id

261 - All items must contain a shop-id / All items must not contain a shop-id

262 - Merchant consumer id and payment method ELV are mand. for using stored bank account information

300 - Transaction initialized

302 - Service is alive

303 - No RMS reason code

306 - Calculation configuration read successful / Profile read successful

307 - Calculation configuration read failed / Profile read failed

309 - Wrong operation order

310 - Transaction id in use

311 - Transaction is reserved for requests by ORCA only

312 - Operation type is reserved for requests by ORCA only

601 - Merchant not eligible for product installment

603 - The payment plan fulfilled the conditions

650 - The condition of amount is not passed. The amount is too low.

651 - The condition of amount is not passed. The amount is too high.

652 - CONFIGURATION_NOT_VALID

671 - The condition of the last rate is not passed

675 - Calculation successful

688 - Rate was too low for long runtime amount

689 - Rate was too low for short runtime amount

695 - Rate was too high to match minimum installment runtime

696 - Rate was too low to match maximum allowed installment runtime

697 - Rate or runtime did not match allowed runtime

698 - Runtime was too long to match maximum allowed installment runtime

699 - Runtime was too short to match minimum allowed installment runtime

700 - Request successful

701 - Merchant limit exceeded / Transaction result error

702 - Transaction result error

703 - Request not successful

720 - Declined - Payment attribute

721 - Declined - Transaction risk

730 - Declined - Buyer identity

800 - Customer not identified, manual check necessary

Change summaries

API Explorer

Payment Change Logic

XML schema files (XSDs)

Shop Modules

PSP's & Marketplaces

Services

Authentication API

Pay Later API

Bank Account Management API

Transaction Status API

Miscellaneous

Regular customers

Device Fingerprinting

Data exchange via SFTP

ORCAWith ORCA you are able to see transactions, submit service requests and download reports about purchase orders and settlements.

ReportingStart with processing Settlement files, clearing files, merchant invoices and submitting regular customers.

LogosWelcome to Europe’s number one White Label payment provider. Here you can get more infos about our corporate identity.

LegalGet ready with the topics of the Ratepay Legal ABC.

Last updated 1 year ago

260: Shop-id in external block is mandatory for this product / Request must not contain shop-id

Refers to Result Code:

150: Processing failed

Legal

Imprint
Privacy Notice
Legal Area

Support

Contact us
Go to ratepay.com

Copyright © Ratepay GmbH 2024. All rights reserved.