Create a oneoff transaction

One-off transactions are necessary for buying and selling of services where the seller get the money all at once upon delivery of the service.

Specify type attribute to 'oneoff'.

post
create a oneoff transaction

https://api.vesicash.com/v1/transactions/create
Request
Response
Request
Headers
Accept
required
string
application/json
V-PRIVATE-KEY
required
string
your vesicash private key
Response
200: OK
{
"status": "ok",
"code": 200,
"message": "Transaction created"
"data": {
"transaction": {
"transaction_id": "FOYA2KPsCU8HZykCDdzw",
"parties_id": "S1SdCuz5eytOh9FUcOd6",
"title": "Build landing page",
"type": "oneoff",
"description": "A new asle",
"amount": 350000,
"status": "Draft",
"currency": "NGN",
"updated_at": "2019-09-23 13:27:41",
"created_at": "2019-09-23 13:27:41",
"inspection_period": 1582542740,
"due_date": 1581465600,
"id": 27,
"parties": [
{
"transaction_id": "FOYA2KPsCU8HZykCDdzw",
"transaction_parties_id": "S1SdCuz5eytOh9FUcOd6",
"account_id": 5841206525,
"role": "buyer",
"created_at": "2019-09-23T13:27:40.791582Z",
"updated_at": "2019-09-23T13:27:40.791612Z"
},
{
"transaction_id": "FOYA2KPsCU8HZykCDdzw",
"transaction_parties_id": "8Tqv3CkH66lpMTRz2CtY",
"account_id": 9432695230,
"role": "seller",
"created_at": "2019-09-23T13:27:40.791645Z",
"updated_at": "2019-09-23T13:27:40.791653Z"
},
{
"transaction_id": "FOYA2KPsCU8HZykCDdzw",
"transaction_parties_id": "M1zQ2M2w32jXeshK2qfZ",
"account_id": 5841206525,
"role": "charge_bearer",
"created_at": "2019-09-23T13:27:40.791668Z",
"updated_at": "2019-09-23T13:27:40.791676Z"
}
],
"inspection_period_formatted": "2020-02-24 11:12:20",
"due_date_formatted": "2020-02-12 00:00:00"
}
}
}

As an example, you can a make a post request to the endpoint above and pass in the raw json data below to create a one-off transaction.

{
"title" : "Design a house plan",
"type" : "oneoff",
"quantity": 1,
"amount": 700000,
"description": "An architectural design of a 3 bedroom apartment in lekki",
"parties": {
"buyer" : 6751951308,
"charge_bearer": 9752720388,
"sender": 9752720388,
"seller": 9752720388,
"recipient": 6751951308
},
"due_date": "2/12/2020",
"inspection_period": 1,
"currency": "NGN"
}

And if the one-off transaction requires an upload of files such as photos or contracts from other sources, all you need to do is pass in the files url as shown below:

See how to upload files to our server and get the file url.

{
"title" : "Design a house plan",
"type" : "oneoff",
"quantity": 1,
"amount": 700000,
"description": "An architectural design of a 3 bedroom apartment in lekki",
"parties": {
"buyer" : 6751951308,
"charge_bearer": 9752720388,
"sender": 9752720388,
"seller": 9752720388,
"recipient": 6751951308
},
"files": [
{
"url": "https://linktodocument.com/contract.pdf"
},
{
"url": "https://linktophoto.com/photo.png"
}
],
"due_date": "2 days",
"inspection_period": "1 day",
"currency": "NGN"
}