On-Ramp

The On-ramp endpoint allows users to fund any wallet address or exchange using fiat(Naira). Users choose a preferred payment gateway and transfer funds from their bank into a generated NUBAN account.

Note: On-ramp is 100% automatic, immediately user sends funds to the generated NUBAN bank information, and the user wallet address will be funded with tokens.

Coin type ( Possible Value)

• USDT_TRC_20

Gateway

On-ramp endpoint success response will show an object which includes a gateway, the object contains 3(Sendcash, Paga, Payaza) payment gateway users can pay into.

Sendcash: An SDK payment gateway that takes the user totally off your application to Sendcash webpage, the user can add bank information to access their account and make payment directly without a new of using their mobile app.

Paga: Paga provides NUBAN account and the amount to pay, then users go to their bank application to send funds directly. Also, provides a USSD payment method. Check the response below.

Payaza : This is similar to the Paga gateway, it will show NUBAN account and the amount to pay. Check the response below.

Note: The amount to pay via Paga and Payaza must be the one provided in the gateway(Paga| Payaza), the transaction will fail if the amount is greater or less than the provided amount.

On-ramp endpoint

POST https://surtii.com/api/v1/business/transaction/onramp

Headers

Name	Type	Description
Authorization*	String	Bearer {{api_key}}

Request Body

Name	Type	Description
address*	String	wallet address
coin_type*	String	USDT_TRC_20
amount*	String	amount in token (e.g 200). Minimum is 10

200: OK Transaction initiated

 "status": true,
    "code": 201,
    "message": "Transaction initiated",
    "data": {
        "address": "TFf9KXJSWFVbCKAenxxxxxxxxxxxxxxxxxxxx",
        "coin_type": "USDT_TRC_20",
        "amount": 12.3,
        "gateways": {
            "sendcash": "https://www.payment.scalex.africa/?r=628226208902236",
            "paga": {
                "request": {
                    "referenceNumber": "628226208902236",
                    "statusCode": "0",
                    "statusMessage": "success",
                    "requestAmount": 7263,
                    "totalPaymentAmount": 7348.44,
                    "currency": "NGN",
                    "paymentMethods": [
                        {
                            "name": "BANK_TRANSFER",
                            "properties": {
                                "AccountNumber": "1937159393"
                            }
                        },
                        {
                            "name": "FUNDING_USSD",
                            "properties": {
                                "USSDShortCode": "*737*000*724+59255414#",
                                "PaymentReference": "59255414"
                            }
                        },
                        {
                            "name": "MONEY_TRANSFER",
                            "properties": {
                                "AccountNumber": "1937159393"
                            }
                        }
                    ],
                    "expiryDateTimeUTC": "2022-04-18T01:41:57",
                    "isPayerPagaAccountHolder": true
                }
            },
            "payaza": {
                "request": {}
            }
        }
    }

400: Bad Request Bad request

{
    "status": false,
    "code": 400,
    "message": "Bad request",
    "data": {}
}

401: Unauthorized Unauthorized

{
    "status": false,
    "code": 401,
    "message": "Unauthorized",
    "data": {}
}