Create Disbursement
Creates a new disbursement in draft
state with basic details. Important: a disbursement is not triggered until the organization adds receivers through the Upload Disbursement Instructions endpoint and the status changes from draft
to ready
.
- application/json
Request Body
- name string
- wallet_id string
- asset_id string
- country_code string
Three-character ISO 3166 code
- 201
- 400
- 401
- 403
A new disbursement
- application/json
- Schema
- Example (from schema)
Schema
- id string
The unique identifier of the disbursement
- name string
The name of the disbursement
country object
code stringThree-character ISO 3166 code
name stringCountry name
created_at date-timeupdated_at date-timewallet object
id stringname stringhomepage stringsep_10_client_domain stringdeep_link_schema stringcreated_at date-timeupdated_at date-timeasset object
id stringcode stringAsset code
issuer stringAsset issuer address
created_at date-timeupdated_at date-timedeleted_at date-time- status string
Possible values: [
DRAFT
,READY
,STARTED
,PAUSED
,COMPLETED
]The status of the disbursement
- verification_field string
Possible values: [
DATE_OF_BIRTH
,PIN
,NATIONAL_ID_NUMBER
] status_history object[]
Array [user_id stringstatus stringPossible values: [
DRAFT
,READY
,STARTED
,PAUSED
,COMPLETED
]timestamp date-time]- file_name string
- created_at date-time
- updated_at date-time
- total_payments integer
Total number of payments
- total_payments_sent integer
Total number of successful payments
- total_payments_failed integer
Total number of failed payments
- total_payments_remaining integer
Total number of remaining payments
- amount_disbursed string
The total amount disbursed so far
- total_amount string
The total amount to be disbursed
- average_amount string
The average amount per payment
{
"id": "619da857-8725-4c58-933d-c120a458e0f5",
"name": "Disbursement Name",
"country": {
"code": "UKR",
"name": "Ukraine",
"created_at": "2023-02-03T10:45:51.000Z",
"updated_at": "2023-02-03T10:45:51.000Z"
},
"wallet": {
"id": "5ada9ed5-455a-4782-a0ee-160767e0deb1",
"name": "Vibrant Assist",
"homepage": "https://vibrantapp.com",
"sep_10_client_domain": "api-dev.vibrantapp.com",
"deep_link_schema": "https://vibrantapp.com/sdp-dev",
"created_at": "2023-07-31T20:50:45.648Z",
"updated_at": "2023-07-31T20:50:45.648Z"
},
"asset": {
"id": "ffaec4b3-46b0-4db4-a4c4-6c3508057705",
"code": "USDC",
"issuer": "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
"created_at": "2023-02-03T10:45:51.000Z",
"updated_at": "2023-02-03T10:45:51.000Z",
"deleted_at": "2023-06-03T10:55:51.000Z"
},
"status": "READY",
"verification_field": "DATE_OF_BIRTH",
"status_history": [
{
"user_id": "3f351b9e-ed0f-40fa-a314-14757b42dab1",
"status": "DRAFT",
"timestamp": "2023-02-03T10:45:51.000Z"
}
],
"file_name": "disbursement-feb-03-2023.csv",
"created_at": "2023-02-03T10:45:51.000Z",
"updated_at": "2023-02-03T10:45:51.000Z",
"total_payments": 10,
"total_payments_sent": 8,
"total_payments_failed": 1,
"total_payments_remaining": 1,
"amount_disbursed": "800.00",
"total_amount": "1000.00",
"average_amount": "100.00"
}
Bad Request
Response Headers
- application/json
- Schema
- Example (from schema)
- response
Schema
- error string
extras object
status numbermessage string
{
"error": "Bad request",
"extras": {
"status": 400,
"message": "Invalid country code provided"
}
}
{
"error": "Bad request",
"extras": {
"status": 400,
"message": "Invalid country code provided"
}
}
Unauthorized
Response Headers
- application/json
- Schema
- Example (from schema)
- response
Schema
- error string
extras object
status numbermessage string
{
"error": "Not authorized",
"extras": {
"status": 401,
"message": "Not authorized"
}
}
{
"error": "Not authorized",
"extras": {
"status": 401,
"message": "Not authorized"
}
}
Forbidden
Response Headers
- application/json
- Schema
- Example (from schema)
- response
Schema
- error string
{
"error": "Forbidden"
}
{
"error": "Forbidden"
}