Creating a payout
Last updated
Last updated
To interact with the API, use the Unitpay PHP-SDK 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"
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)
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
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