Riverty Invoice
Riverty Invoice
Shoppers who choose Riverty’s invoice are subject to predefined payment terms to pay the invoice and shall pay the full purchase amount on the invoice due date. The due date is always calculated based on the dispatch date of the goods, not the purchase date.
The most common terms of payment are within 14 days after the purchase, which gives shoppers enough time to experience the goods before paying. The full purchase amount is to be paid by the due date.
Authorization
When the customer on session chooses to take an invoice or installment by Riverty, an authorization request has to be sent to QENTA Checkout Server with the necessary customer and basket details.
After completing the payment process, consumers are redirected to the online shop and receive relevant information on the result or state of the payment which is sent to the respective SUCCESSURL
, CANCELURL
or FAILUREURL
.
Commands
Pre Transaction Commands
The first step is to generate a unique order number with the command CREATEORDER.
Transaction Commands
INITIATEPAYMENT
Request Parameters
Required Parameters | Optional Parameters | ||||
---|---|---|---|---|---|
|
|
||||
|
Required Parameters | ||
---|---|---|
|
||
Optional Parameters |
||
|
||
|
Optional request parameters CUSTOMERSTATEMENT
and ORDERREFERENCE
, are more restricted concerning their length and allowed characters than usual.
Initialization example
Riverty invoice can be initialized if the merchant sends RIVERTY-INV for parameter INITTYPE , and RIVERTY for PAYMENTTYPE .
|
-
Send a request.
Example of Request for InitiationCOMMAND=INITIATEPAYMENT& MERCHANTKEY=43gADp5.UOZxPTet6O8o8K6o-7RefQB3BO21OMu4chB65LJUI_& INITTYPE=RIVERTY-INV& PAYMENTTYPE=RIVERTY& ORDERNUMBER=11604468& LANGUAGE=en& AMOUNT=55& CURRENCY=EUR& SERVICEURL=http://yourimprint.com/& OVERWRITE_WAKEUPMESSAGE=TRUE& USER_AGENT=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.81 Safari/537.36 Edg/104.0.1293.47& ACCEPT_HEADERS=text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,/;q=0.8,application/signed-exchange;v=b3;q=0.9& BROWSER_JAVA_ENABLED=0& BROWSER_JAVASCRIPT_ENABLED=1& BROWSER_ACCEPT_HEADERS=text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,/;q=0.8,application/signed-exchange;v=b3;q=0.9& BROWSER_SCREEN_RESOLUTION=1920x1080& BROWSER_COLOR_DEPTH=24& BROWSER_USER_AGENT=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.81 Safari/537.36 Edg/104.0.1293.47& BROWSER_LANGUAGE=en-GB& BROWSER_CHALLENGE_WINDOW_SIZE=05& BROWSER_TIME_ZONE=-120& CUSTOMERSTATEMENT=Test005& SUCCESSURL=https://yoursuccessurl.com& FALLBACK=FALSE& ORDERDESCRIPTION=Test:0000& IP_ADDRESS=172.20.0.231& APPLICATIONTYPE=S& WAKEUPMESSAGE_METHOD=PAGE& CONSUMER_EMAIL=test@qenta.com& CONSUMER_BILLING_FIRST_NAME=Qenta& CONSUMER_BILLING_LAST_NAME=Tester& CONSUMER_BILLING_ADDRESS_1=Reininghausstrasse 10& CONSUMER_BILLING_CITY=Graz& CONSUMER_BILLING_ZIP_CODE=8020& CONSUMER_BILLING_COUNTRY=AT& CONSUMER_BIRTH_DATE=2000-09-01& CONSUMER_IP_ADDRESS=195.34.137.202& CONSUMER_SHIPPING_FIRST_NAME=Qenta& CONSUMER_SHIPPING_LAST_NAME=Tester& CONSUMER_SHIPPING_ADDRESS_1=Reininghausstrasse 10& CONSUMER_SHIPPING_CITY=Graz& CONSUMER_SHIPPING_ZIP_CODE=8020& CONSUMER_SHIPPING_COUNTRY=AT& BASKET_ITEMS=1& BASKET_ITEM_1_ARTICLE_NUMBER=42& BASKET_ITEM_1_UNIT_TAX_RATE=10.0& BASKET_ITEM_1_UNIT_NET_AMOUNT=50.0& BASKET_ITEM_1_UNIT_GROSS_AMOUNT=55.0& BASKET_ITEM_1_NAME=BasketItem1& BASKET_ITEM_1_UNIT_TAX_AMOUNT=5.0& BASKET_ITEM_1_QUANTITY=1&
-
The response looks like this:
Example of Respons for Initiationversion=qtillserver+3.23.0.47& status=0
Because this is a synchronous payment method, the result is provided immediately.
VERIFYPAYMENT
Response Parameters
Required Parameters | Optional Parameters | ||
---|---|---|---|
|
Verifying payment example
-
Send a request.
Request ParametersMERCHANTKEY=43gADp5.UOZxPTet6O8o8K6o-7RefQB3BO21OMu4chB65LJUI_& COMMAND=VERIFYPAYMENT& APPLICATIONTYPE=S& ORDERNUMBER=11604468& LANGUAGE=en&
-
The response looks like this:
Response Parametersorder.1.amount=55.00& payment.1.1.paymentNumber=11604468& payment.1.1.depositAmount=55.00& order.1.orderText=Test%3A0000& order.1.contractNumber=72ee7187-cf31-4aae-9773-20d6bec114af& payment.1.1.timeModified=31.10.2022+13%3A20%3A28& payment.1.1.paymentType=RIVERTY& order.1.merchantNumber=840& payment.1.1.state=payment_deposited& order.1.depositAmount=55.00& order.1.customerStatement=Test005& order.1.providerContractNumber=72ee7187-cf31-4aae-9773-20d6bec114af& order.1.timeModified=31.10.2022+13%3A20%3A28& payment.1.1.providerReferenceNumber=11604468& order.1.orderNumber=11604468& payment.1.1.gatewayReferenceNumber=11604468& payment.1.1.orderNumber=11604468& payment.1.1.approveAmount=55.00& order.1.approveAmount=0& order.1.credits=0& payment.1.1.merchantNumber=840& order.1.payments=1& order.1.currency=EUR& version=qtillserver+3.23.0.48& order.1.refundAmount=0& payment.1.1.currency=EUR& order.1.timeCreated=31.10.2022+13%3A20%3A27& order.1.state=ORDERED& order.1.orderDescription=Test%3A0000& orders=1& payment.1.1.timeCreated=31.10.2022+13%3A20%3A28& payment.1.1.batchNumber=300000594& order.1.acquirer=Riverty& order.1.paymentType=RIVERTY& order.1.brand=invoice& status=0
Post Transaction Commands
GETORDERDETAILS
Response Parameters
Required Parameters | Optional Parameters | ||
---|---|---|---|
|
Getting order details example
-
Send a request.
Request ParametersMERCHANTKEY=43gADp5.UOZxPTet6O8o8K6o-7RefQB3BO21OMu4chB65LJUI_& COMMAND=GETORDERDETAILS& ORDERNUMBER=11604468& ADMIN_PASSWORD=9p3a0m5f& APPLICATIONTYPE=S&
-
The response looks like this:
Response Parametersorder.1.amount=55.00& payment.1.1.paymentNumber=11604468& payment.1.1.depositAmount=55.00& order.1.orderText=Test%3A0000& order.1.contractNumber=72ee7187-cf31-4aae-9773-20d6bec114af& payment.1.1.timeModified=31.10.2022+13%3A20%3A28& payment.1.1.paymentType=RIVERTY& order.1.merchantNumber=840& payment.1.1.state=payment_deposited& order.1.depositAmount=55.00& order.1.customerStatement=Test005& order.1.providerContractNumber=72ee7187-cf31-4aae-9773-20d6bec114af& order.1.orderNumber=11604468& order.1.timeModified=31.10.2022+13%3A20%3A28& payment.1.1.providerReferenceNumber=11604468& payment.1.1.gatewayReferenceNumber=11604468& payment.1.1.orderNumber=11604468& objectsTotal=1& payment.1.1.approveAmount=55.00& order.1.approveAmount=0& order.1.credits=0& payment.1.1.merchantNumber=840& order.1.payments=1& order.1.currency=EUR& version=qtillserver+3.23.0.48& order.1.state=ORDERED& order.1.timeCreated=31.10.2022+13%3A20%3A27& payment.1.1.currency=EUR& order.1.refundAmount=0& rder.1.orderDescription=Test%3A0000& orders=1& payment.1.1.timeCreated=31.10.2022+13%3A20%3A28& order.1.paymentType=RIVERTY& order.1.brand=invoice& order.1.acquirer=Riverty& payment.1.1.batchNumber=300000594& status=0
DEPOSIT
The transaction is automatically deposited by using the command INITIATEPAYMENT, in this case, the command DEPOSIT isn’t used. Look at the order flow diagram of the payment method for closer information. |
Riverty transactions are by default set to be approved and deposited in one step, but it can be split it up into a two-step process. That allows distinguishing between approved and deposited payments and performing certain actions for each of them.
To separate the transaction flow into authorization and capture, get in contact with the integration specialists. Look at the order flow diagram of the payment method for closer information.
APPROVEREVERSAL
For using the command APPROVEREVERSAL, payment needs to be in an approved state. Look at the order flow diagram of the payment method for closer information. |
This command is only possible for a two-step transaction, by default this payment method is immediately deposited. Contact our integration specialists to change the configuration of this payment method. |
REFUND
Request Parameters
Required Parameters | Optional Parameters | ||
---|---|---|---|
|
Refunding example
-
Send a request.
Request ParametersMERCHANTKEY=43gADp5.UOZxPTet6O8o8K6o-7RefQB3BO21OMu4chB65LJUI_& COMMAND=REFUND& ORDERNUMBER=8704489& CURRENCY=EUR& AMOUNT=55.00& ADMIN_PASSWORD=9p3a0m5f& APPLICATIONTYPE=S& LANGUAGE=en
-
The response looks like this:
Response ParameterscreditNumber=14995999& version=qtillserver+3.23.0.48& status=0
Query Commands
For every payment method commands QUERYORDERS, QUERYCREDITS, and QUERYBATCHES are used.