Comment on page


Event request data
For now, LocalRamp only sends webhook on four events
  1. 1.
    When the customer sends fiat for a buy transaction.
  2. 2.
    When LocalRamp sends the crypto equivalent to the wallet address.
  3. 3.
    When a sell transaction is successfully completed.
  4. 4.
    When a swap transaction is successfully completed.
The webhook request body will look like
Buy (Fiat Received)
Buy (Crypto Sent)
Sell Completed
Swap Completed
"event_type": "buy.fiat_received",
"reference": "myTransactionReference",
"sent_amount": "12991.32",
"sender_currency": "NGN"
"event_type": "buy.crypto_sent",
"reference": "myTransactionReference",
"received_amount": "0.0116196",
"receiver_currency": "ETH_ETH",
"txid": "<txID>"
"event_type": "sell.completed",
"reference": "SELL_KYZSHIEMOqPg",
"from_currency": "LTC",
"to_currency": "NGN",
"to_amount": "1158.96"
"event_type": "swap.completed",
"reference": "SWAP_ukS6sPUx9sx7V1qE",
"from_currency": "BNB",
"to_currency": "USDT",
"to_amount": "1.98"
If LocalRamp does not get a 2xx response, we'll retry the endpoint every 30 minutes for 2 hours before we give up.