Affiliates
Commissions
Copy
curl -X GET "https://api.affonso.io/v1/payouts/pay_abc123" \
-H "Authorization: Bearer sk_live_your_api_key"
Copy
{
"success": true,
"data": {
"id": "pay_abc123",
"affiliateId": "aff_456def",
"invoiceNumber": 1001,
"amount": 150.00,
"status": "pending",
"paymentMethod": "paypal",
"paymentReference": null,
"processedAt": null,
"managedPayout": true,
"affiliate": {
"name": "John Doe",
"email": "[email protected]"
},
"transactions": [
{
"id": "txn_123",
"amount": 50.00,
"commission": {
"id": "com_456",
"amount": 100.00,
"commissionAmount": 50.00,
"createdAt": "2024-01-20T10:00:00Z"
},
"createdAt": "2024-01-25T10:00:00Z"
}
],
"createdAt": "2024-01-25T10:00:00Z",
"updatedAt": "2024-01-25T10:00:00Z"
}
}
Payouts
Get Payout
Retrieve a single payout by ID with transaction details
GET
/
v1
/
payouts
/
{id}
Copy
curl -X GET "https://api.affonso.io/v1/payouts/pay_abc123" \
-H "Authorization: Bearer sk_live_your_api_key"
Copy
{
"success": true,
"data": {
"id": "pay_abc123",
"affiliateId": "aff_456def",
"invoiceNumber": 1001,
"amount": 150.00,
"status": "pending",
"paymentMethod": "paypal",
"paymentReference": null,
"processedAt": null,
"managedPayout": true,
"affiliate": {
"name": "John Doe",
"email": "[email protected]"
},
"transactions": [
{
"id": "txn_123",
"amount": 50.00,
"commission": {
"id": "com_456",
"amount": 100.00,
"commissionAmount": 50.00,
"createdAt": "2024-01-20T10:00:00Z"
},
"createdAt": "2024-01-25T10:00:00Z"
}
],
"createdAt": "2024-01-25T10:00:00Z",
"updatedAt": "2024-01-25T10:00:00Z"
}
}
Path Parameters
The unique identifier of the payout to retrieve
Response
The response includes the payout object with transaction details.Always
true for successful responsesThe payout object.
Show Data Object Properties
Show Data Object Properties
Unique identifier for the payout
The affiliate ID who will receive this payout
Invoice number for this payout
Total payout amount
Payout status (lowercase):
pending, processing, completed, failed, cancelledPayment method used for the payout
External payment reference (e.g., PayPal transaction ID)
ISO 8601 timestamp when the payout was processed
Whether this is a managed payout
Affiliate information object containing:
name(string | null): Affiliate nameemail(string | null): Affiliate email
Array of payout transaction objects. Each transaction contains:
id(string): Transaction IDamount(number): Transaction amountcommission(object): Commission details withid,amount,commissionAmount,createdAtcreatedAt(string): ISO 8601 creation timestamp
ISO 8601 timestamp of when the payout was created
ISO 8601 timestamp of when the payout was last updated
Copy
curl -X GET "https://api.affonso.io/v1/payouts/pay_abc123" \
-H "Authorization: Bearer sk_live_your_api_key"
Copy
{
"success": true,
"data": {
"id": "pay_abc123",
"affiliateId": "aff_456def",
"invoiceNumber": 1001,
"amount": 150.00,
"status": "pending",
"paymentMethod": "paypal",
"paymentReference": null,
"processedAt": null,
"managedPayout": true,
"affiliate": {
"name": "John Doe",
"email": "[email protected]"
},
"transactions": [
{
"id": "txn_123",
"amount": 50.00,
"commission": {
"id": "com_456",
"amount": 100.00,
"commissionAmount": 50.00,
"createdAt": "2024-01-20T10:00:00Z"
},
"createdAt": "2024-01-25T10:00:00Z"
}
],
"createdAt": "2024-01-25T10:00:00Z",
"updatedAt": "2024-01-25T10:00:00Z"
}
}
⌘I