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
Table 1. Request Parameters
Required Parameters Optional Parameters

MERCHANTKEY

LOGPATH

COMMAND

LANGUAGE

INITTYPE

ORDERREFERENCE

PAYMENTTYPE

CUSTOMERSTATEMENT

AMOUNT

SERVICEURL

CURRENCY

APPLICATIONTYPE

ORDERNUMBER

IP_ADDRESS

ORDERDESCRIPTION

ORIGINATOR

The consumer billing data and basket item parameters are required.
In addition to these optional request parameters, also is recommended to send Riverty consumer shipping data containing detailed information regarding the consumers.
The basket data parameters are in general optional, all parameters need to be set, except for BASKET_ITEM_<m>_DESCRIPTION and BASKET_ITEM_<m>_IMAGE_URL which remain optional.
Table 2. Request Parameters
Required Parameters

MERCHANTKEY

COMMAND

INITTYPE

PAYMENTTYPE

AMOUNT

CURRENCY

ORDERNUMBER

ORDERDESCRIPTION

The consumer billing data and basket item parameters are required.

Optional Parameters

LOGPATH

LANGUAGE

ORDERREFERENCE

CUSTOMERSTATEMENT

SERVICEURL

APPLICATIONTYPE

IP_ADDRESS

ORIGINATOR

In addition to these optional request parameters, also is recommended to send Riverty consumer shipping data containing detailed information regarding the consumers.
The basket data parameters are in general optional, all parameters need to be set, except for BASKET_ITEM_<m>_DESCRIPTION and BASKET_ITEM_<m>_IMAGE_URL which remain optional.

Optional request parameters CUSTOMERSTATEMENT and ORDERREFERENCE, are more restricted concerning their length and allowed characters than usual.

Response Parameters
Table 3. Response Parameters
Required Parameters Optional Parameters

status

header

version

body

errorCode

message

paySysMessage

originator

Initialization example
Riverty invoice can be initialized if the merchant sends RIVERTY-INV for parameter INITTYPE, and RIVERTY for PAYMENTTYPE.
  1. Send a request.

    Example of Request for Initiation
    COMMAND=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&
  2. The response looks like this:

    Example of Respons for Initiation
    version=qtillserver+3.23.0.47&
    status=0

    Because this is a synchronous payment method, the result is provided immediately.

VERIFYPAYMENT

Request Parameters
Table 4. Request Parameters
Required Parameters Optional Parameters

MERCHANTKEY

LOGPATH

COMMAND

LANGUAGE

ORDERNUMBER

APPLICATIONTYPE

PAYMENTNUMBER

QTILL_CLIENT_IP_ADDRESS

ORIGINATOR

Response Parameters
Table 5. Response Parameters
Required Parameters Optional Parameters

status

orders

version

errorCode

message

paySysMessage

originator

Order as a basis type of properties in the response can be returned for this command.
Verifying payment example
  1. Send a request.

    Request Parameters
    MERCHANTKEY=43gADp5.UOZxPTet6O8o8K6o-7RefQB3BO21OMu4chB65LJUI_&
    COMMAND=VERIFYPAYMENT&
    APPLICATIONTYPE=S&
    ORDERNUMBER=11604468&
    LANGUAGE=en&
  2. The response looks like this:

    Response Parameters
    order.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

Request Parameters
Table 6. Request Parameters
Required Parameters Optional Parameters

MERCHANTKEY

LOGPATH

COMMAND

LANGUAGE

ORDERNUMBER

APPLICATIONTYPE

ADMIN_PASSWORD

ORIGINATOR

Response Parameters
Table 7. Response Parameters
Required Parameters Optional Parameters

status

orders

version

errorCode

message

paySysMessage

originator

Order as a basis type of properties in the response can be returned for this command.
Getting order details example
  1. Send a request.

    Request Parameters
    MERCHANTKEY=43gADp5.UOZxPTet6O8o8K6o-7RefQB3BO21OMu4chB65LJUI_&
    COMMAND=GETORDERDETAILS&
    ORDERNUMBER=11604468&
    ADMIN_PASSWORD=9p3a0m5f&
    APPLICATIONTYPE=S&
  2. The response looks like this:

    Response Parameters
    order.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.
Request Parameters
Table 8. Request Parameters
Required Parameters Optional Parameters

MERCHANTKEY

LOGPATH

COMMAND

LANGUAGE

ORDERNUMBER

CURRENCY

PAYMENTNUMBER

AMOUNT

ADMIN_PASSWORD

APPLICATIONTYPE

ORIGINATOR

Response Parameters
Table 9. Response Parameters
Required Parameters Optional Parameters

status

orders

version

errorCode

message

paySysMessage

originator

REFUND

Request Parameters
Table 10. Request Parameters
Required Parameters Optional Parameters

MERCHANTKEY

LOGPATH

COMMAND

LANGUAGE

ORDERNUMBER

APPLICATIONTYPE

AMOUNT

CREDITNUMBER

ADMIN_PASSWORD

CURRENCY

MERCHANTREFERENCE

CUSTOMERSTATEMENT

ISO_TRANSACTION_TYPE

ORIGINATOR

For refunds, basket item data are additional optional parameters.
Response Parameters
Table 11. Response Parameters
Required Parameters Optional Parameters

status

orders

version

errorCode

message

paySysMessage

originator

creditNumber

Refunding example
  1. Send a request.

    Request Parameters
    MERCHANTKEY=43gADp5.UOZxPTet6O8o8K6o-7RefQB3BO21OMu4chB65LJUI_&
    COMMAND=REFUND&
    ORDERNUMBER=8704489&
    CURRENCY=EUR&
    AMOUNT=55.00&
    ADMIN_PASSWORD=9p3a0m5f&
    APPLICATIONTYPE=S&
    LANGUAGE=en
  2. The response looks like this:

    Response Parameters
    creditNumber=14995999&
    version=qtillserver+3.23.0.48&
    status=0

Query Commands

For every payment method commands QUERYORDERS, QUERYCREDITS, and QUERYBATCHES are used.