action.skip

Payment Provider Integration

JustOn Cash Management can integrate your Salesforce org with payment service providers (PSP) in order to exchange payment information – namely, to provide your buyers the option to pay their purchases (represented as entries) via the payment page.

For details, see Integrating Payment Provider.

Payment Workflow via Payment Provider

In broad strokes, payment requests are processed as follows:

pay_app_pay_process

JustOn Cash Management prepares payment
JustOn Cash Management encrypts the involved entries and publishes the payment page it to the buyer.
Buyer executes payment

The buyer selects a payment service provider or payment method and releases the payment transaction.

JustOn Cash Management creates a Payment record with the status Pending and an Entry Item record with an Expected Amount.

Payment provider captures amount

The payment service provider captures the payment amount in the buyer's bank and notifies JustOn Cash Management about the result.

JustOn Cash Management creates a Payment Notification record that represents the capture result.

  • The Payment Notification record has an Amount value set.
  • The Payment record's Status is set Collected and its Collected Amount is registered.
  • On the Entry Item record, the Expected Amount is deleted and an Assigned Amount value is set – which is transferred to the related Entry record as Assigned Amount.
  • With the Open Amount completely covered, the Entry record's Status is set Balanced.
  • The Payment Notification record has an empty Amount.
  • The Payment record's Status remains or is reset Pending.
  • The Entry Item record keeps or is restored its Expected Amount.
  • The related Entry record's Status remains or is reset Open.
Bank transfers money
The buyer's bank transfers the captured amount to the payment service provider. Subsequently, the payment service provider passes the amount to the merchant's bank.

Info

Collecting payments via PSPs and, consequently, settling the corresponding entries does not involve bank accounts.

The money transfer between the banks does not alter the payment and entry status or the settlement result.

Payment Page

JustOn Cash Management includes a payment page. It provides your buyers the option to pay their purchases (represented as entries) via integrated payment service providers.

In order to invite your buyers to pay, you publish a link to your payment page. This payment link looks like

https://payment.juston.cloud/pay/:link-id/to/:tenant

where :link-id encodes the relevant entries and :tenant represents your organization.

For details, see Configuring Payment Page.

Text customization

Depending on your requirements, you can modify or translate the texts to be displayed on the payment page. To this end, JustOn Cash Management provides the custom Salesforce object Payment Page Configuration.

Payment page configurations hold customized texts or translations for payment page texts. Once payment page configuration records are available for a given locale, JustOn Cash Management retrieves the texts when loading the payment page.

Additional pages

Your business may require to publish payment-relevant information that does not "fit" in the text components of the payment page. To support this, you create additional custom pages that are linked with the payment page. You can use this, for example, to attach your terms and conditions.

JustOn Cash Management implements support for custom pages using the Salesforce object CMS Page. Once CMS Page records are available for a given locale and set Active, JustOn Cash Management produces a list of links to these custom pages in the payment page footer when loading the payment page.

Clicking a link opens the page in a modal window. Closing this window returns the user to the payment page, ready to continue the payment process.

Payment Automation

Payment providers may offer support for pre-authorized, merchant-initiated payment transactions – provider-specific means to pre-authorize and execute recurring charges (or other subsequent payments) without the need to repeatedly prompt customers for interaction.

Info

Usually, merchant-initiated transactions are specifically negotiated with and provided by payment service providers. Contact your PSP for details.

To support future payments and the automatic payment collection, JustOn Cash Management holds payment instruments. As part of the payment provider configuration, merchants can enable an option to save payments instruments for future use in the field Save Payment Instrument. The following settings are available:

Option Result
Disabled Payment data will not be saved, no display on the payment page.
Explicit Consent Displays a toggle switch to let buyers decide whether to save payment data or not, preset No.
Buyers must expressly agree to the payment data storage.
Explicit Opt-out Displays a toggle switch to let buyers decide whether to save payment data or not, preset Yes.
Buyers must expressly reject the payment data storage.
Indirect Consent Payment data will be saved when the payment is made, displays a text to inform buyers about this.
Buyers indirectly agree to the payment data storage when making the payment.

Once configured, the payment page exposes the selected option to buyers. The texts to be displayed with each option are configurable:

Context Relevant Text Field Default Value
Indirect consent Storage Indirect Consent By clicking **Pay** you allow [company] to save and use your payment data for future payments.
Explicit consent
Explicit opt-out
Storage Optional Consent Allow your payment data to be saved and used again for future payments.
Successful data storage Storage Result Heading Payment Data
Data storage failure Storage Results Error Message We could not save your payment data. But this is not a problem, we will ask you to save it again when you make the next payment.

Refund via Payment Provider

Typically, users initialize refunds based on the original payment in JustOn Cash Management. Certain circumstances, however, may require refunds to be initialized via a payment service provider. In this case, any transactions will synchronize with JustOn Cash Management via webhook notifications. Subsequently, JustOn Cash Management will update both payment and refund records accordingly:

  • Each webhook notification results in the creation of a Payment Notification record linked to the original Payment record. The payment notification captures current changes or data related to the payment and refund.
  • Based on the webhook notification, JustOn Cash Management creates or updates a corresponding Refund record, with the Open Amount in accordance with the refunded payment (see Refund Amount Values). This ensures the accurate reflection of the refund status in JustOn Cash Management.
  • Should the refund status update to Refunded, JustOn Cash Management will adjust the Open Amount and the Collected Amount of the related payment (see Payment Amount Values) in accordance with the refunded amount.
  • Any related entries might also be updated in response to the refund processing, ensuring that settled amounts remain up-to-date.

JustOn Cash Management supports refunds in response to payments made via Mollie.

Be aware that refunds initialized via payment service providers may require some manual processing, see Managing Payment Provider-Initiated Refunds.