{
    "id": null,
    "status": "pending",
    "amount": {
        "currency": null,
        "value": null
    },
    "source": {
        "financialAccountId": null,
        "transactionReference": null
    },
    "destination": {
        "type": "bank"
    },
    "fees": [],
    "failureDetail": {
        "code": "unknown",
        "message": null
    },
    "createTime": null,
    "updateTime": null,
    "ownershipGraph": {
        "owner": {
            "id": null,
            "type": null,
            "metadata": null,
            "": null
        }
    },
    "metadata": null
}
Payout is a disbursement of funds from a Financial Account to a designated destination (e.g., bank or MOMO account). It includes the amount, source of funds, destination details, and optional metadata.
Each payout tracks its status (e.g., pending, processing, completed) and may record provider-specific references. Payouts are typically used for salaries, refunds, or vendor payments in automated workflows. 
{
    "id": null,
    "status": "pending",
    "amount": {
        "currency": null,
        "value": null
    },
    "source": {
        "financialAccountId": null,
        "transactionReference": null
    },
    "destination": {
        "type": "bank"
    },
    "fees": [],
    "failureDetail": {
        "code": "unknown",
        "message": null
    },
    "createTime": null,
    "updateTime": null,
    "ownershipGraph": {
        "owner": {
            "id": null,
            "type": null,
            "metadata": null,
            "": null
        }
    },
    "metadata": null
}
​
📋
Properties
​
id
string
Unique identifier for the payout object.
​
status
enum<string>
Current status of the payout:
  • ‘pending’: Created but not yet scheduled.- ‘processing’: Currently being processed.
  • ‘completed’: Successfully completed.
  • ‘failed’: Processing failed or rejected.
Available options: pending processing completed failed
​
amount
object
Amount to be paid to the destination provider account.
​
source
object
SourceAccount of funds, including debit account and transaction details. Can be null if the default account is used.
​
destination
object
Destination account details that will receive the payout.
​
fees
array
List of fees applied during payout processing. Empty if not yet processed.
​
failureDetail
object
Detailed information about the failure, if the payout status is ‘failed’.
​
createTime
string
Timestamp indicating when the payout object was created.
​
updateTime
string
Timestamp indicating when the payout object was last updated.
​
ownershipGraph
object
Full ownership graph tracing the origin of this payout objects across multiple objects.
​
metadata
object
Optional metadata attached to the payout for additional context.