CloudPayments
Accept and manage payments via CloudPayments — a leading Russian payment gateway
cl
CloudPayments is one of the leading Russian payment gateways supporting card payments, Apple Pay, Google Pay, and installment plans. It provides a comprehensive API for payment acceptance, subscription management, and fiscal receipt generation (54-ФЗ compliant).
With the CloudPayments integration in AACFlow, you can:
- Create payments: Initiate card payment sessions and generate payment links
- Check payment status: Retrieve the status and details of individual transactions
- Create subscriptions: Set up recurring billing for subscription products
- Cancel payments: Void or refund payments
- Issue fiscal receipts: Generate 54-ФЗ compliant online cash register receipts
This integration enables automated payment processing and subscription management for Russian e-commerce workflows.
Usage Instructions
Integrate CloudPayments into the workflow. Requires a Public ID and API Secret from your CloudPayments merchant account at dashboard.cloudpayments.ru.
Tools
cloudpayments_create_payment
Create a payment
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
publicId | string | Yes | CloudPayments Public ID |
apiSecret | string | Yes | CloudPayments API Secret |
amount | number | Yes | Payment amount |
currency | string | Yes | Currency code (e.g. RUB) |
description | string | Yes | Payment description |
invoiceId | string | No | Merchant invoice ID |
email | string | No | Customer email |
Output
| Parameter | Type | Description |
|---|---|---|
transactionId | number | CloudPayments transaction ID |
url | string | Payment URL to redirect customer |
success | boolean | Whether the payment was created |
cloudpayments_get_payment
Get payment status
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
publicId | string | Yes | CloudPayments Public ID |
apiSecret | string | Yes | CloudPayments API Secret |
transactionId | number | Yes | Transaction ID to check |
Output
| Parameter | Type | Description |
|---|---|---|
status | string | Payment status |
amount | number | Payment amount |
currency | string | Currency code |
createdAt | string | Transaction creation time |
cloudpayments_refund
Refund or cancel a payment
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
publicId | string | Yes | CloudPayments Public ID |
apiSecret | string | Yes | CloudPayments API Secret |
transactionId | number | Yes | Transaction ID to refund |
amount | number | No | Partial refund amount (omit for full refund) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the refund was processed |
message | string | Result message |
Links
- Official API: https://developers.cloudpayments.ru/
- AACFlow block source: apps/aacflow/blocks/blocks/cloudpayments.ts