Self-payout

Read on how to instructions for self-payout of transactions

Once a transaction has been successfully created and has moved to pending state, you will be able to request for delivery through the delivery-request API. Upon receiving the delivery request, Machnet will verify if the transaction has passed all the compliance checks. Once all checks are completed, the delivery status will be changed to `DELIVERY_AUTHORIZED`.‘transaction_delivery_authorized’ webhook event will also be sent upon authorization.

Update Transaction Delivery Status

If you have an agreement with Machnet for self-payout, once you receive the authorization, the transaction can be paid out. Depending on the results of the payout, payout status needs to be updated using the below API.

POST /senders/{{senderId}}/transactions/{{transactionId}}/delivery-details

Details

Parameter	Type	Required	Description
date_delivered	LocalDateTime	Yes	The time of delivery/ failure of payout YYYY-MM-DD HH:MM:SS e.g.2019-07-06 00:00:00
status	String	Yes	Delivery Status: “DELIVERED”, “DELIVERY_FAILED”
note	String	Conditional	Note about the delivery. 1. Note is not required in case the delivery is successful. 2. If the payout is not successful, you will need to update the failure reason in the note.
referenceNumber	String	No	Reference number of the Payout Partner
file	Base64	No	Proof of delivery may be required for transactions based on compliance requirements.
file_name	String	No	File name

Request Sample

curl -X POST {{url}}/senders/{{senderId}}/transactions/{{transactionId}}/delivery-details \
--header 'X-Client-Id: client_id' \
--header 'X-Client-Secret: client_secret' \
--header 'Content-Type: application/json' \
--data '{
    "date_delivered" : "2019-07-06 00:00:00",
    "status" : "delivery_status",
    "reference_number" : 5657575,
    "file_name" : "fileName.pdf",
    "file" : "base64 file"
}'

Response Sample

204