Triggering the webhooks

post https://sandbox.oneramp.io/webhooks

This page will help you get started with WebHook Endpoint.

The webhook is authorised by a separated webhook key that can be generated on the oneramp dashboard

To generate the and sign the webhook signature see the helper code repo below:

Run the full webhook endpoint in postman:

Remember the web-hook payload body is the response of the transfer status endpoint

Responses

Language

Credentials

Request


xxxxxxxxxx
30
1
curl --location 'https://sandbox.oneramp.io/webhooks' \
2
--header 'fiatconnect-signature: <-signature-key->' \
3
--header 'Content-Type: application/json' \
4
--header 'Authorization: Bearer <-webhook-secret-key->' \
5
--header 'Cookie: <-cookie-session->' \
6
--data '{
7
    "eventType": "WebhookTransferOutStatusEvent",
8
    "provider": "OneRamp",
9
    "eventId": "evt_1234567890abcdef",
10
    "timestamp": "1234567890",
11
    "address": "0x5272bB6A1A4d09cEef6377D9A9cXXXXXXXX",
12
    "payload": {
13
        "status": "TransferStarted",
14
        "transferType": "TransferOut",
15
        "fiatType": "UGX",
16
        "cryptoType": "cUSD",
17
        "amountProvided": "753.905651796",
18
        "amountReceived": "746.290443192",
19
        "fiatAccountId": "6596b0c09fa51456cc188e41",
20
        "transferId": "6596b0f29fa51456cc188e48",
21
        "transferAddress": "0x5272bB6A1A4d0XXXXX",
22
        "userActionDetails": {
23
            "userActionType": "AccountNumberUserAction",
24
            "institutionName": "OneRamp",
25
            "accountName": "OneRamp",
26
            "accountNumber": "25656",
27
            "transactionReference": "ref-<-key->"
28
        }
29
    }

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

400400