Skip to navigation

Solvimon Payments

Solvimon Payments lets you collect invoice payments without a payment service provider contract of your own. It is built on Adyen for Platforms: Solvimon holds the Adyen account and onboards your business as a sub-merchant. In Desk it appears as the Adyen Payments integration (ownership: SYSTEM). Your customers pay through Solvimon, and Adyen pays out the funds to your bank account.


Solvimon Payments or your own Adyen account

Solvimon PaymentsYour own Adyen account
Adyen contractNot necessary. Solvimon onboards you on its platform.You contract with Adyen directly
Integration in DeskAdyen Payments, created by SolvimonCreated by you with your API key, company account and merchant accounts
Payment acceptorCreated for you on your billing entity (cards only by default)You add it
WebhooksSolvimon manages them. No setup is necessary.You configure them, or Solvimon does with company-level access
FeesSolvimon splits its processing fee off each payment before payoutAdyen invoices you directly
Payouts, reports, disputesIn Desk under PaymentsIn your Adyen Customer Area
API ownership valueSYSTEMPLATFORM

Availability

Your billing entity must be registered in a supported country:

  • Europe: Austria, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Gibraltar, Greece, Guernsey, Hungary, Ireland, Isle of Man, Italy, Jersey, Latvia, Liechtenstein, Lithuania, Luxembourg, Malta, Netherlands, Norway, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden, Switzerland, United Kingdom
  • North America: Canada, Puerto Rico, United States
  • Asia Pacific: Australia, Hong Kong, New Zealand, Singapore

For a new sandbox with a billing entity in a supported country, Solvimon automatically creates these resources:

  • The Adyen Payments integration.
  • Your Adyen legal entity, account holder and balance account. The balance account uses your default billing currency.
  • A payment acceptor on your billing entity. New subscriptions use it by default.

For other countries, Solvimon does not create an integration. On your live platform, Solvimon sets this up when you go live.

Set up Solvimon Payments

1

Try it in your sandbox

Your sandbox is ready to take payments: the integration and the payment acceptor already exist. Finalize an invoice for a test customer. Then pay it from the customer portal with an Adyen test card.

2

Go live

Solvimon Payments goes live together with your live platform. When you request your live platform, tell your Solvimon contact that you want to use Solvimon Payments. Solvimon then does these steps:

  • Creates the Adyen Payments integration on your live platform. The integration creates your Adyen legal entity, account holder and balance account from your billing entity. Thus, your live billing entity must exist first.
  • Registers your business line (industry and website) with Adyen.
  • Creates your store. The store routes your payments to your balance account and applies Solvimon’s fee split.
  • Adds the Adyen Payments payment acceptor to your billing entity. You do not have to create one.

You cannot change the store or the fee split in Desk or through the API. Live payments succeed only after the store exists and Adyen verifies your business.

3

Verify your business

Adyen must verify your business (KYC) before it can pay out funds to you. Do this on your live platform. In the sandbox, verification uses Adyen test data.

  1. In Desk, go to Payments → Payouts overview.
  2. The banner at the top shows your verification status. Select the link in the banner to open Adyen’s hosted onboarding in a new tab.
  3. Provide the company details that Adyen requests.
  4. Add the bank account for your payouts. Adyen verifies the bank account as part of the check.

The banner appears once the Adyen Payments integration is active and your legal entity exists. You can come back to it at any time to check the status or update your details.

Solvimon enables the Transactions overview, Payouts overview, Reports overview and Disputes overview pages for your account. If you do not see them under Payments, contact Solvimon Support.

4

Check your payment acceptor

You do not need to add a payment acceptor. Solvimon automatically adds an Adyen Payments payment acceptor to your billing entity and makes it the default for new subscriptions. The acceptor has these settings:

  • It stores the customer’s payment method.
  • It charges the stored payment method automatically when an invoice becomes final.
  • It retries refused card payments with Auto Rescue for 30 days.
  • It allows cards only.

To review or change it, go to Settings → Billing entities in Desk. Open the billing entity and edit the acceptor. To accept payments for another billing entity, add an acceptor there and choose the Adyen Payments integration. There is no merchant account to select.

FieldDescription
Allowed payment methodsLimits checkout to the selected methods. Leave empty to offer all methods enabled on the integration. The acceptor Solvimon creates allows scheme (cards) only.
Store payment methodTokenizes the payment method so that Solvimon can charge later invoices.
Auto charge payment methodCharges the stored payment method automatically when an invoice becomes final.
Auto rescueRetries refused card payments with Adyen Auto Rescue within the period you set (1–48 days or 1–6 weeks).

To offer more than cards, update allowed_payment_methods on the acceptor with PATCH /v1/payment-acceptors/{id}:

Allow cards, SEPA Direct Debit and iDEAL
curl -X PATCH https://test.api.solvimon.com/v1/payment-acceptors/paya_LwDgUp0tNc6SmYAr4f1E \
-H "X-API-KEY: <apiKey>" \
-H "Content-Type: application/json" \
-d '{
"payment_gateway": {
"integration_id": "intg_QwDfTn0sVk8RjXLu2a1M",
"store_payment_method": true,
"auto_charge_payment_method": true,
"collection_type": "LINK",
"adyen": {
"allowed_payment_methods": ["scheme", "sepadirectdebit", "ideal"],
"auto_rescue": {
"enabled": true,
"period": { "type": "DAY", "value": 30 }
}
}
}
}'
Response
{
"object_type": "PAYMENT_ACCEPTOR",
"id": "paya_LwDgUp0tNc6SmYAr4f1E",
"billing_entity_id": "bile_JwDhRq0sBd9FkZCt8g1P",
"reference": "adyen_payments",
"name": "Adyen Payments",
"type": "PAYMENT_GATEWAY",
"payment_gateway": {
"integration_id": "intg_QwDfTn0sVk8RjXLu2a1M",
"store_payment_method": true,
"auto_charge_payment_method": true,
"collection_type": "LINK",
"adyen": {
"auto_rescue": {
"enabled": true,
"period": { "type": "DAY", "value": 30 }
},
"allowed_payment_methods": ["scheme", "sepadirectdebit", "ideal"]
}
},
"status": "ACTIVE"
}

To add an acceptor for another billing entity, use POST /v1/payment-acceptors:

Create a Solvimon Payments payment acceptor
curl -X POST https://test.api.solvimon.com/v1/payment-acceptors \
-H "X-API-KEY: <apiKey>" \
-H "Content-Type: application/json" \
-d '{
"billing_entity_id": "bile_JwDhRq0sBd9FkZCt8g1P",
"reference": "solvimon-payments",
"type": "PAYMENT_GATEWAY",
"payment_gateway": {
"integration_id": "intg_QwDfTn0sVk8RjXLu2a1M",
"store_payment_method": true,
"auto_charge_payment_method": true,
"collection_type": "LINK",
"adyen": {
"allowed_payment_methods": ["scheme", "sepadirectdebit"],
"auto_rescue": {
"enabled": true,
"period": { "type": "DAY", "value": 28 }
}
}
}
}'

Do not send merchant_account for a Solvimon Payments integration. The API rejects the request.

Payment methods

Solvimon manages the methods enabled on the Adyen Payments integration (enabled_payment_methods, read-only). By default these are:

CategoryMethods (API value)
CardsVisa (visa), Mastercard (mc), American Express (amex), Maestro (maestro), V Pay (vpay), Elo (elo), generic card (scheme)
WalletsApple Pay (applepay), Google Pay (googlepay), PayPal (paypal)
OtheriDEAL (ideal), Klarna (klarna), SEPA Direct Debit (sepadirectdebit)

Three settings decide what a customer can pay with:

  • The methods enabled on the integration. Solvimon manages these methods, and the table above lists them.
  • The allowed_payment_methods on the payment acceptor. The acceptor that Solvimon creates allows cards only. An empty list allows every enabled method.
  • The methods that Adyen offers for the invoice’s currency and the customer’s country. For example, iDEAL only appears for EUR payments.

The payment page that opens from an invoice’s payment link currently offers card, Apple Pay and Google Pay only. To pay with another allowed method, such as SEPA Direct Debit or iDEAL, the customer can pay the invoice from the customer portal.

Manage payments, payouts and disputes

Everything is under Payments in Desk:

PageWhat it shows
OverviewSolvimon payments with their customer, invoice, payment method and status. Open a payment to see its details or refund it, fully or partially.
Transactions overviewTransactions on your balance account, including split details per payment.
Payouts overviewPayouts to your bank account, plus the verification banner.
Reports overviewDownloadable Adyen reports.
Disputes overviewChargebacks and disputes, which you can accept or defend from this page. A chargeback also sets the Solvimon payment status to Charged back.

The four overview pages are Adyen components, scoped to your Adyen account holder. Refund payments from Payments → Overview, so that Solvimon records the refund on the payment and the invoice.

Adyen deducts a chargeback from your balance account. If Adyen already paid out the funds, it deducts the chargeback from your next payout.

Limitations

  • Only Transactions overview shows split details. The Solvimon payment object does not.
  • Transactions overview does not link to Solvimon customers or invoices. Use Payments → Overview for that.
  • Desk shows payouts, transactions, reports and disputes for one Solvimon Payments integration per platform.
  • Solvimon creates your Adyen legal entity as an organization from your billing entity’s legal name and country. You add everything else in Adyen’s hosted onboarding.
  • Do not edit the Adyen Payments integration in Desk. Solvimon manages its settings.