Payout

Payout Object Properties and Data Types

id

Description

Munify’s Payout Identifier.

Type

UUID

customer_reference

Description

Customer Payout Reference (Sent on initiating the payout).

Type

String

created

Description

Payout Timestamp.

Type

DateTime (Iso Format)

bank

Description

Payout Receiver Bank

Type

Object

bank.name

Description

Payout Receiver Bank Name.

Type

String

bank.code

Description

Payout Receiver Bank Code.

Type

Enum Bank Codes

receiver_name

Description

Payout Receiver Name.

Type

String

receiver_phone

Description

Payout Receiver Phone.

Type

String

receiver_identifier

Description

Payout Receiver Identifier. (Wallet Phone Number, Bank Account Number, Card Number)

Type

String

amount

Description

Payout Actual Amount.

Type

Decimal

fixed_fee_amount

Description

Payout Fixed Fee Amount (If any)

Type

Decimal

variable_fee_amount

Description

Payout Variable Fee Amount (If any)

Type

Decimal

total_amount

Description

Payout Total Amount (amount + fixed_fee_amount + variable_fee_amount).

Type

Decimal

currency

Description

Payout Currency Code.

Type

Enum Currency

status

Description

Payout Status Enum Value.

Type

Enum Payout Status

type

Description

Payout Type Enum Value.

Type

Enum Payout Type

description

Description

Payout description.

Type

String

timeline

Description

List of payout status change history.

Type : object

KeyType
onDate (Iso Format)
statusEnum Payout Statuses

failure_reason

Description

The reason behind failure if any.

Type

String

Payout JSON Object

"payout": {
  "id": "37c23ed0-5001-11ef-9454-0242ac120002",
  "customer_reference": "123456",
  "created": "2024-08-03T12:07:22.714321",
  "bank": {
    "name": "Commercial International Bank - Egypt S.A.E",
    "code": "CIB"
  },
  "receiver_name": "Ali Ahmed Mohamed Ahmed",
  "receiver_phone": "+201XXXXXXXXX",
  "receiver_identifier": "12345678901234",
  "amount": 1576.85,
  "fixed_fee": 10,
  "variable_fee": 15.77,
  "total_amount": 1551.08,
  "currency": "EGP",
  "status": "REJECTED",
  "payout_type": "BANK_ACCOUNT",
  "description": "Subscription Fees",
  "timeline": [
    {
      on: "2024-08-05T12:39:24.940517Z",
      status: "INITIATED",
    },
    {
      on: "2024-08-07T16:25:32.495071Z",
      status: "REJECTED",
    },
  ],
  "failure_reason" : "Unregistered receiver wallet"
}