Checkout
Transactions
Payment Methods
Webhooks and Callbacks
Payer Information
Batch payout request
Payouts at PayMee are cash-out transactions;
Before we start, there are some important tips:
- you must have sufficient funds;
- you shoud provide a valid and complete beneficiary details
- Register your server CIDR for production enviroment
curl --request POST \
--url https://api.paymee.com.br/v1.1/payout/create/batch \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--header 'x-api-token: <x-api-token>' \
--data '{
"payments": [
{
"amount": 1,
"beneficiary": {
"bankDetails": {
"account": "000001-5",
"bankCode": "077",
"branch": "0001",
"type": "CHECKING"
},
"document": {
"number": "00000000000",
"type": "CPF"
}
},
"email": "foo@bar.com",
"notes": "example-01",
"referenceCode": "X540QG02",
"scheduledDate": "2020-11-29 15:00:00"
},
{
"amount": 1.99,
"beneficiary": {
"bankDetails": {
"account": "000002-2",
"branch": "7444",
"type": "CHECKING"
},
"document": {
"number": "00000000001",
"type": "CPF"
}
},
"email": "foo1@bar.com",
"notes": "example-02",
"referenceCode": "X540QG12",
"scheduledDate": "2020-11-25 00:00:00"
},
{
"amount": 3.99,
"beneficiary": {
"bankDetails": {
"account": "000022-0",
"bankCode": "104",
"branch": "7474",
"type": "SAVING"
},
"document": {
"number": "00000000002",
"type": "CPF"
}
},
"email": "foo2@bar.com",
"notes": "saving-account-example",
"referenceCode": "X540QG22"
}
]
}'
{
"message": "success",
"result": [
{
"amount": 1,
"appliedRate": 3.5,
"creation": "2019-11-21 19:33:00",
"currency": "BRL",
"discounts": 0,
"id": 1103460,
"situation": "PENDING",
"total": 1,
"type": "PAYOUT",
"uuid": "734150a2-3377-3717-832c-6f142ece7fa8"
},
{
"amount": 1.99,
"appliedRate": 3.5,
"creation": "2019-11-21 19:33:00",
"currency": "BRL",
"discounts": 0,
"id": 1103461,
"situation": "PENDING",
"total": 1.99,
"type": "PAYOUT",
"uuid": "b8784391-8d54-3d72-a9e6-5db10499c674"
},
{
"amount": 3.99,
"appliedRate": 3.5,
"creation": "2019-11-21 19:33:00",
"currency": "BRL",
"discounts": 0,
"id": 1103462,
"situation": "PENDING",
"total": 3.99,
"type": "PAYOUT",
"uuid": "ad4d5020-c896-324e-8979-03b7b5e63895"
}
],
"resultSize": 3,
"status": 0,
"totalElements": 3,
"totalPages": 1
}
Headers
"your-x-api-key"
"your-x-api-token"
Body
Array of payment requests
ISO-4217 currency code - default: BRL
3
Payout amount
1
Unique order identifier
50
"X540QG02"
Beneficiary's bank account type
CHECKING
, SAVING
, UNKNOWN
"CHECKING"
Beneficiary's bank code (COMPE code)
3
"077"
Beneficiary's bank branch number
8
"0001"
Beneficiary's bank account number
18
"000001-5"
Beneficiary's email
75
Payment trigger date - format 'yyyy-MM-dd HH:mm:ss' (timezone GMT-3)
"2020-11-29 15:00:00"
Individual callback URL
2083
Payment optional notes
255
"example-01"
Email for notifications
"foo@bar.com"
Response
"success"
0
3
3
1
1103460
"734150a2-3377-3717-832c-6f142ece7fa8"
"PAYOUT"
"PENDING"
"BRL"
1
3.5
1
"2019-11-21 19:33:00"
0
"success"
0
3
3
1
1103460
"734150a2-3377-3717-832c-6f142ece7fa8"
"PAYOUT"
"PENDING"
"BRL"
1
3.5
1
"2019-11-21 19:33:00"
0
"partial success"
1
2
2
1
curl --request POST \
--url https://api.paymee.com.br/v1.1/payout/create/batch \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--header 'x-api-token: <x-api-token>' \
--data '{
"payments": [
{
"amount": 1,
"beneficiary": {
"bankDetails": {
"account": "000001-5",
"bankCode": "077",
"branch": "0001",
"type": "CHECKING"
},
"document": {
"number": "00000000000",
"type": "CPF"
}
},
"email": "foo@bar.com",
"notes": "example-01",
"referenceCode": "X540QG02",
"scheduledDate": "2020-11-29 15:00:00"
},
{
"amount": 1.99,
"beneficiary": {
"bankDetails": {
"account": "000002-2",
"branch": "7444",
"type": "CHECKING"
},
"document": {
"number": "00000000001",
"type": "CPF"
}
},
"email": "foo1@bar.com",
"notes": "example-02",
"referenceCode": "X540QG12",
"scheduledDate": "2020-11-25 00:00:00"
},
{
"amount": 3.99,
"beneficiary": {
"bankDetails": {
"account": "000022-0",
"bankCode": "104",
"branch": "7474",
"type": "SAVING"
},
"document": {
"number": "00000000002",
"type": "CPF"
}
},
"email": "foo2@bar.com",
"notes": "saving-account-example",
"referenceCode": "X540QG22"
}
]
}'
{
"message": "success",
"result": [
{
"amount": 1,
"appliedRate": 3.5,
"creation": "2019-11-21 19:33:00",
"currency": "BRL",
"discounts": 0,
"id": 1103460,
"situation": "PENDING",
"total": 1,
"type": "PAYOUT",
"uuid": "734150a2-3377-3717-832c-6f142ece7fa8"
},
{
"amount": 1.99,
"appliedRate": 3.5,
"creation": "2019-11-21 19:33:00",
"currency": "BRL",
"discounts": 0,
"id": 1103461,
"situation": "PENDING",
"total": 1.99,
"type": "PAYOUT",
"uuid": "b8784391-8d54-3d72-a9e6-5db10499c674"
},
{
"amount": 3.99,
"appliedRate": 3.5,
"creation": "2019-11-21 19:33:00",
"currency": "BRL",
"discounts": 0,
"id": 1103462,
"situation": "PENDING",
"total": 3.99,
"type": "PAYOUT",
"uuid": "ad4d5020-c896-324e-8979-03b7b5e63895"
}
],
"resultSize": 3,
"status": 0,
"totalElements": 3,
"totalPages": 1
}