Webhook updates

When the order status changes, we will send you a webhook notification, the following is the event list when we send the webhook:

We send webhooks/callbacks only for transaction events in our system. If the webhook URL is not set before the transaction is completed, the webhook will not be sent. Please note that if the payment site is not publicly available for internet requests, then the HTTP notifications about fund transfers from our processing service will not be able to reach your application.

When a user makes a payment, the Processing Service notifies your application of the fund transfer by making an HTTP request to your application's URL in the following format:

Kindly ensure that you use an HTTPS endpoint with a valid SSL certificate that is trusted by your browser. Otherwise, this can result in missing webhook updates at times.

Steps:

• Pass Callback URL to the Create Order API / Callback can be predefined in the Merchant console under API hub area.

• Rampnow will send Callback after each transaction to the Callback URL

• The URL should accept a POST request

• The URL should accept a request body that looks like the following

Webhook sample

{
    "merchantTransactionId": "915c3134-a522-41a7-a928-32667f17ad7f",
    "amount": 100,
    "currency": "EUR",
    "status": "ACCEPTED|REJECTED|CANCELED|PENDING|AUTHORIZED|EXPIRED|REFUNDED",
    "hash": "28EE6604A8A40ACC8B8CE0B8DE9AAC87A4E24BBF0388A48ED164E512C8073C7E",
    "paymentMethod": {
        "name": "Apple Pay",
        "channel": "Apple Pay",
        "parameters": {}
    },
    "customer": {
        "firstName": "John",
        "lastName": "Doe",
        "email": "[e-mail]",
        "ip": "172.89.0.1",
        "country": "US"
    },
    "email": "[e-mail]",
    "baseCurrency": "EUR",
    "baseCurrencyAmount": 0.5,
    "exchangeRate": 1,
    "cryptocurrency": "USDT",
    "cryptocurrencyAmount": 0.5308278259946386,
    "cryptoExchangeRate": 1.0616556519892772
}

Status	Description
ACCEPTED	User payment is successful
REJECTED	User payment failed rejected by the payment gateway
CANCELED	user payment is cencelled since the customer canceled the payment session
PENDING	User payment is pending to be cleared. the final status is always Completed or cancelled. Sofort is the only transaction methods takes longer time(approx. 3 working days) to completed. rest of other payment methods gets completed in few seconds to few minutes.
AUTHORIZED	User payment Authorised by payment gateway and waiting for completion. This is not the last status
EXPIRED	The user session is expired without payment being made
REFUNDED	The customer payment is refunded by the request from merchant / partner

HTTP method

• POST merchant-defined api

• Content-Type: application/json

Example callback address of your system

https://your-domian.com/api/callback-notification

Webhook sample

Response Fields:

Field	Description
merchantTransactionId	Transaction identifier passed in create order API by Merchant / Partner
amount	Transaction amount
currency	Transaction currency
status	Transaction status possible values are ACCEPTED|REJECTED|CANCELED|PENDING|AUTHORIZED|EXPIRED|REFUNDED.
hash	Transaction crypto Hash for the instant settlement. Note : This field will be sent with values only when the merchant has provided with instant settlement.
paymentMethod:name	Payment type chosen for the transaction
paymentMethod:channel	Payment type chosen for the transaction
paymentMethod:parameters	any additional parameter for payment type, It will be empty for now
customer:firstName	Customer first name
customer:lastName	Customer last name
customer:email	Customer email address
customer:ip	Customer's IP location where the transaction is originated.
customer:country	Customer's country location where the transaction is originated.
email	Customer email address
baseCurrency	Base currency of transaction. always EUR
baseCurrencyAmount	Base currency amount taken for transaction in EUR
exchangeRate	Exchange rate between base currency and transaction currency
cryptocurrency	settlement cryptocurrency value
cryptocurrencyAmount	amount in settlement cryptocurrency
cryptoExchangeRate	Exchange rate between base currency and crypto settlement currency

Authentication of Notification

• To verify whether the IPN is sent by Rampnow, you should verify the hash sent to you

  • Concatenate the following values and generate a hash using SHA256

    • sha256({merchantTransactionId}{currency}{amount}{status}{clientSecret})

  • Make sure you have the correct client secret

  • Compare the hash you generated with the hash sent to you and verify that it matches