[Pear2Pay] Payments Integration
Welcome to the integration guide for Pear2Pay. This document will help you integrate Pear2Pay into your website.
Requirements
- Create the API Key for your merchant account in the admin panel at
(Authorization) Signatures
The Signatures section provides detailed information about how to secure your API requests using digital signatures. It explains the signature generation process, required parameters, and includes code examples for implementing request signing in different programming languages to ensure secure communication with the Pear2Pay API.
Integration Types
(H2H) Host to Host Integrations
Host to Host (H2H) integration allows your website to communicate directly with Pear2Pay's servers without involving the user interface. This type of integration is typically used for automated workflows where you want to handle invoice creation and payout confirmations programmatically.
(H2F) Host to Form Integrations
Host to Form (H2F) integration uses a web-based form hosted by Pear2Pay. Instead of managing the transaction process directly, your website redirects the user to the Pear2Pay-hosted form to input their payment or payout details.
Formulas
Invoices (Pay IN)
An invoice represents a financial transaction where a client sends a payment to a merchant. It serves as a formal record of the payment request and contains essential details such as the amount, payment method, and transaction status. In the Pear2Pay system, invoices are used to track and process incoming payments from clients to merchants.
Formula for Payment to Merchant:
pay_to_merchant = amount / (rate * (1 + fee))
// crypto_amount is the invoice total amount, no feePossible Statuses for Invoice
Payouts (Pay OUT)
A payout represents a financial transaction where a merchant sends funds to a client. This process involves transferring money from the merchant's account to the client's designated payment method. Payouts are commonly used for various purposes such as refunds, withdrawals, or compensating service providers.
Formula for Payment to Client:
pay_to_client = amount / (rate * (1 - fee))
// crypto_amount is the payout_invoice total amount, no fee