Creating a Payout
Last updated
Last updated
To interact with the API, use the Unitpay PHP-SDK library
Required parameters:
Additional parameters:
****
If you need to check the status of a payment after creating it, use the "Information about Payout"
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
You can run the query in test mode. Learn more
Successful response
Error response
Errors:
Technical errors:
Value
Description
projectId
number
Unique project ID in the UnitPay system
comment
text
Comment on the payment. It is displayed only in your personal account (only letters, numbers, dots and commas are allowed)
Value
Description
message
line
The comment of a successful transaction can be used as a hint to the user after completing the request
status
line
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
text
Payout creation date
completeDate
text
Payout completion date
sum
number
Amount of payout
payoutCommission
number
Payout commission
partnerCommission
number
Partner commission
Value
Description
message
line
Information with a description of the request error
code
line
Error code, see detailed explanation in the table below
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
Description
-32000
Authorization error
-32602
Invalid request parameters
-32603
Internal technical error
Value
Description
login
line
Partner's email in the UnitPay system
secretKey
line
Partner's secret key, available in the profile settings
purse
line
Payee's purse in the format accepted in the payment system
transactionId
text
Unique payout ID on the partner's side
sum
number
The transfer amount in rubles, for example: "10.22"
paymentType
line
Payment system code: Supported: qiwi, card, mc, yandex