Post Transfer initialization

https://api.magmasend.com/v2/transaction

Initiate transfer

This guide will help you initiate a transfer to any Magmasend available corridor for cash pickup

Request Information

Parameter Name	Type	Mandatory	Description
transaction_id	String	Mandatory	Your transaction Id
notify_url	Url	Mandatory	Callback URL, this url will be called after an update on the transaction
payment_method	String	Mandatory	Delivery Method
payout_amount	Integer	Mandatory	Amount the receiver should get
payout_country	ISO2 country	Mandatory	Destination Country
payout_currency	ISO 4217 Currency	Mandatory	Currency of the transfer
receiver_phone_number	String	Mandatory	Receive's mobile number
sender_reference	String	Mandatory	A unique sender's reference ID
receiver_reference	String	Mandatory	A unique Receiver's reference ID

HEADERS

Authorization	Bearer TOKEN

Body raw (json)

{
	"transaction_id": "UniqueID",
	"notify_url": "https://m.com",
	"payment_method": "MobileMoney",
	"payout_amount": 1000,
	"payout_currency": "XOF",
	"payout_country": "CI",
	"relation": "family",
	"sender_reference": "senderReferenceID",
	"receiver_reference": "receiverReferenceID",
	"receiver_phone_number": "+22505xxxxxxxx"
    
}

curl --location 'https://api.magmasend.com/v2/transaction' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer token' \
--data '{
	"transaction_id": "17e7a946-9dc5-45ae-b302-9208a9b54fe6",
	"notify_url": "https://m.com",
	"payment_method": "MobileMoney",
	"payout_amount": 1000,
	"payout_currency": "XOF",
	"payout_country": "CI",
	"relation": "family",
	"sender_reference": "C6CA6EDECE",
	"receiver_reference": "7978976A0A",
	"receiver_phone_number": "+2250707000200"
}'

Example success Response

{
    "code": 201,
    "status": "CREATED",
    "comment": "Transaction initiated successfully, you should confirm it now",
    "transaction": {
        "reference": 82435064225,
        "transaction_id": "5IM2GKYRDDLB7SD",
        "payment_method": "MobileMoney",
        "payout_amount": 1000,
        "payout_country": "CI",
        "sending_currency": "XOF",
        "sending_amount": 1000,
        "sending_fee_amount": 10,
        "exchange_rate": 1,
        "sender_reference": "C6CA6EDECE",
        "receiver_reference": "7978976A0A",
        "status": "WAITING_PARTNER_CONFIRMATION",
        "comment": "This transaction must be confirmed by sender partner"
    }
}

Example failed Response

{
    "code": 400,
    "status": "DATA_NOT_VALID",
    "comment": "payout_currency is not available for the payout_country"
}