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'.
{"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/12/2020","inspection_period": 1,"currency": "NGN"}