Payment use case

The pay widget link can be configured in multiple ways to meet all your needs.

Use case

Simple Payment (Purchase via Store)

Allow users to make direct payments for purchases in your store using our payment solution at checkout.

ParameterDescription
pw_confidentiality_walletConfidentiality wallet ID where the widget is loaded
pw_descriptionFree label for the operation
pw_transaction_refPayment Reference/ID internal of the marketplace. Must be unique per privacy scope to avoid double transactions.
pw_beneficiary_0Marketplace confidentiality id with fees of the transaction formatted as "ID|AMOUNT".

Example: https://app.pleenk.com/payment?pw_confidentiality_wallet=CONFIDENTIALITY_WALLET_ID&pw_description=A-simple-payment&pw_transaction_ref=ORDER-123&pw_beneficiary_0=CONFIDENTIALITY_WALLET_ID|10

Payment on Behalf of a Third Party (Purchase via Store for Third-Party Seller)

Enable users to purchase items from your store, directing payments to third-party sellers' accounts using our payment solution.

ParameterDescription
pw_confidentiality_walletConfidentiality wallet ID where the widget is loaded
pw_descriptionFree label for the operation
pw_transaction_refPayment Reference/ID internal of the marketplace. Must be unique per privacy scope to avoid double transactions.
pw_beneficiary_0Marketplace confidentiality id with fees of the transaction formatted as "ID|AMOUNT".
pw_beneficiary_1First beneficiary information of the transaction formatted as "PleenkEntityRef|AMOUNT". Amount uses "." as the decimal separator with no limits on decimals.

Example:https://app.pleenk.com/payment?pw_confidentiality_wallet=CONFIDENTIALITY_WALLET_ID&pw_description=A-simple-payment&pw_transaction_ref=ORDER-123&pw_marketplace_fee=2&pw_beneficiary_0=CONFIDENTIALITY_WALLET_ID|2&pw_beneficiary_1=SELLER_ID|10

Payment with Manual Confirmation

Integrate a feature where users can manually confirm payments before processing, adding an extra layer of security.

ParameterDescription
pw_confidentiality_walletConfidentiality wallet ID where the widget is loaded
pw_descriptionFree label for the operation
pw_transaction_refPayment Reference/ID internal of the marketplace. Must be unique per privacy scope to avoid double transactions.
pw_manual_confirmTimeout for confirmation duration
pw_beneficiary_0Marketplace confidentiality id with fees of the transaction formatted as "ID|AMOUNT".

Example:https://app.pleenk.com/payment?pw_confidentiality_wallet=CONFIDENTIALITY_WALLET_ID&pw_description=A-payment-with-confirm&pw_transaction_ref=ORDER-123&pw_beneficiary_0=CONFIDENTIALITY_WALLET_ID|10&pw_manual_confirm=PT1M

Payment with Segregation of Funds

Facilitate payments that are automatically split into different accounts based on predefined rules, ensuring proper distribution of funds.

ParameterDescription
pw_confidentiality_walletConfidentiality wallet ID where the widget is loaded
pw_descriptionFree label for the operation
pw_transaction_refPayment Reference/ID internal of the marketplace. Must be unique per privacy scope to avoid double transactions.
pw_beneficiary_0Marketplace confidentiality id with fees of the transaction formatted as "ID|AMOUNT".
pw_funds_blocking_periodEscrow duration

Example:https://app.pleenk.com/payment?pw_confidentiality_wallet=CONFIDENTIALITY_WALLET_ID&pw_description=A-simple-payment&pw_transaction_ref=ORDER-123&pw_beneficiary_0=CONFIDENTIALITY_WALLET_ID|10&pw_funds_blocking_period=PT1M

Recurring Payment

Offer a recurring payment option for regular services or subscriptions, with automatic processing based on user-specified amounts and frequencies.

ParameterDescription
pw_confidentiality_walletConfidentiality wallet ID where the widget is loaded
pw_descriptionFree label for the operation
pw_transaction_refPayment Reference/ID internal of the marketplace. Must be unique per privacy scope to avoid double transactions.
pw_beneficiary_0Marketplace confidentiality id with fees of the transaction formatted as "ID|AMOUNT".
pw_subscription_periodRecurring period of paiement

Example:https://app.pleenk.com/payment?pw_confidentiality_wallet=CONFIDENTIALITY_WALLET_ID&pw_description=A-simple-payment&pw_transaction_ref=ORDER-123&pw_beneficiary_0=CONFIDENTIALITY_WALLET_ID|10&pw_subscription_period=P1M