Unitpay
en
en
  • Home
  • First steps
    • Registration
    • Adding a Project
      • Adding a VK Community Project
    • Project Moderation
    • Transfer of the Project
    • Video tutorials
  • Payments
    • Creating a payment (easy way)
    • Creating a Payment
    • Creating a payment (widget)
    • Parameters for receipts
    • Creating Payment Links in Your Personal Account
    • Payment Handler
    • Payment information
    • Payment Refund
    • Payments with Pre-authorization
    • Recurring payments
      • Creating a Subscription
      • Getting Information About Subscription
      • Getting a List of Active Subscriptions
      • Closing a Subscription
  • Mass payouts
    • Creating a payout
    • Information about Payout
    • Card information by BIN
    • Payments based on a CSV registry
  • Online cash desk
    • Parameters for generating a receipt
    • Unit.Reciepts
    • Adding online cash desk
    • Types of Online Cash Register Receipt Items
    • Advance credit reciepts
  • Modules
    • Payment handler
    • Unitpay SDK
    • CMS modules
      • Amiro
      • PHPShop
      • 1C Bitrix
      • CS-Cart
      • DIAFAN.CMS
      • Drupal 7 (commerce)
      • Drupal 7 (ubercart 3)
      • Drupal 8, 9 (commerce)
      • Ecwid by Lightspeed
      • HostCMS
      • InSales
      • Joomshopping 4 (joomla 3)
      • LogicBoxes
      • Magento
      • Magento 2
      • OpenCart
      • osCommerce
      • Prestashop
      • ReadyScript
      • ShopCMS
      • Simpla
      • Tilda
      • Netcat CMS
      • UMI.CMS
      • VamShop 2
      • VirtueMart 3 (joomla 3)
      • Webasyst Shop Script 7 (8)
      • Wix
      • Woocommerce Wordpress
      • Zen Cart
      • Amiro CMS
      • CMS NWICODE
      • MODX (miniShop2)
  • Manage Unitpay
    • Interface Instructions
    • SP documents
    • Legal entity documents
    • Current Balance
    • Commissions
    • Currency Conversion Rates
  • Book of reference
    • System IP addresses
    • Payment Form Appearance
    • Using the Test API
    • Operator Codes
    • Payment System Codes
    • Currency codes
    • Qiwi Country Codes
  • Referral program
    • Interface of Referrer's (Agent's) Account
  • Support
  • Other
    • Telegram bot
    • Using the Test API
  • Google Pay™
Powered by GitBook
On this page

Was this helpful?

  1. Mass payouts

Creating a payout

PreviousMass payoutsNextInformation about Payout

Last updated 1 year ago

Was this helpful?

To interact with the API, use the library

Required parameters:

​

Value

Description

login

string

Partner's email in the UnitPay system

secretKey

string

Partner's secret key, available in the profile settings​

purse

string

Payer's purse (wallet or card) in the format accepted in the payment system

transactionId

string

Unique payout ID on the partner's side

sum

number

The transfer amount in rubles, for example: "10.22"

paymentType

string

Additional parameters:

​

Value

Description

projectId

number

Unique project ID in the UnitPay system

comment

string

Comment on the payment. It is displayed only in your personal account (only letters, numbers, dots and commas are allowed)

IMPORTANT NOTE: always use a unique transactionId for new payouts; when you get an existing transactionId (regardless of other parameters), the current payout status is returned

Successful response

{"result": {
    "message": "Выплата успешно проведена",
    "status": "success",
    "payoutId": "114233",
    "partnerBalance": "15733.00",
    "createDate": "2021-12-01 11:51:02",
    "completeDate": "2021-12-01 11:52:02",
    "sum": "300",
    "payoutCommission": "6.00",
    "partnerCommission": "0.00"
}}

​

Value

Description

message

string

The comment of a successful transaction can be used as a hint to the user after completing the request

status

string

success — successful payout not_completed — the payout has been sent to the payment system but no confirmation has been received yet (temporary status)

payoutId

number

Unique payout ID in the UnitPay system

partnerBalance

number

Partner's balance in the system available for payments

createDate

string

Payout creation date

completeDate

string

Payout completion date

sum

number

Amount of payout

payoutCommission

number

Payout commission

partnerCommission

number

Partner commission

Error response

​

Value

Description

message

string

Information with a description of the request error

code

int

Error code, see detailed explanation in the table below

Errors:

​

Description

100

Mass payment service is disabled

101

Mass payment service is not available for you

102

The minimum amount of a single payment should be more than 1 ruble

103

The payout amount should be less than or equal to the current balance

104

The phone number is not included in the list of countries available for payouts

1051

We could not get information about the payee's purse. Check the purse number and try to repeat the transaction again or after a while

1052

We could not get information about the card number. Check the card number and try to repeat the transaction again or after a while

1053

We could not get information about the phone number. Check the phone number and try to repeat the transaction again or after a while

201

We could not transfer funds to the account you specified This may be due to the restrictions on the payee's account or errors on the payment system platform Please contact our customer support for more information or repeat the request later

Technical errors:

​

Description

-32000

Authorization error

-32602

Invalid request parameters

-32603

Internal technical error

​: Supported: qiwi, card, webmoney, usdt

If you need to check the status of a payment after creating it, use the

You can run the query in test mode.

"Information about Payout"
Learn more
Payment system code
Unitpay PHP-SDK