riverty logo

Docs

Get Started Login

Available Payment Methods

Returns the available payment methods for a specified basket value and merchant contract. Returns monthly installment amount, interest and fees. Main use-case is Two-Step Authorize.

More information can be found in our Documentation.

Path

POST /api/v3/checkout/payment-methods

Request Body

application/json

parentTransactionReference
string
Max length: 128
A unique reference provided to Riverty by a third party (merchant or Payment Service Provider). Identifies an entire order.
object
Additional data
yourReference
string
Max length: 20
Can be used by purchasing company if they would like to provide internal reference
ourReference
string
Max length: 128
Can be used by selling company if they would like to provide specific reference for purchasing company. This field is limited to 128 characters, longer values will be truncated to fit within the specified limit.
conversationLanguage
string
Enum:

NO

SV

FI

DA

EN

DE

NL

FR

The language code used for client communication. If not provided, the system will default to the language configured for the client.
country
string
Enum:

NO

SE

FI

DK

DE

AT

CH

NL

BE

Country code
object
object
The person initiating the checkout, typically the buyer who places the order. May also receive the order.
object
The recipient of the order, potentially different from the buyer. Specifies the delivery address and contact details.
required
object
Order object

Responses

Successful Request, 14 Day InvoiceSuccessfull Request, All Payment MethodsUnsuccessful Request, Incorrect Order Value

Request Example

    
        {
 "conversationLanguage": "EN",
 "order": {
  "country": "DE",
  "totalGrossAmount": "185",
  "totalNetAmount": "155.41",
  "currency": "EUR"
 }
}
    

Response Example

    
        {
 "checkoutId": "4e4eadfb-30b8-452e-96a5-1edcba9cb3b9",
 "outcome": "Accepted",
 "paymentMethods": [
  {
   "type": "Invoice",
   "title": "Invoice - 14 days",
   "tag": "Buy now, Pay in 14 days",
   "consumerFeeAmount": 2,
   "logo": "https://cdn.riverty.design/logo/riverty-checkout-logo.svg",
   "legalInfo": {
    "termsAndConditionsUrl": "https://documents-dev.riverty.dev/terms_conditions/payment_methods/invoice/de_en/default",
    "privacyStatementUrl": "https://documents-dev.riverty.dev/privacy-statement/checkout/de_en",
    "text": "The <a href=\"https://documents-dev.riverty.dev/terms_conditions/payment_methods/invoice/de_en/default\">General Terms and Conditions</a> for the Riverty payment method apply. The Privacy Policy of Riverty can be found <a href=\"https://documents-dev.riverty.dev/privacy-statement/checkout/de_en\">here</a>."
   }
  }
 ]
}