Sell Ramp

This endpoint can be used to intiate an NGNC Off-ramp transaction.

Initiate a Sell Transaction.

Use this endpoint to perform a sell transaction POST api.ngnc.online/transactions/v1/offramp

Shell

curl --request POST \
     --url https://api.ngnc.online/transactions/v1/offramp \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'ngnc-sec-key: NGNC_SECRET_KEY' \
     --data '
{
    "business_id": "string",  
    "link_tag": "string", 
    "type": "string", 
    "amount": 0,  
    "account_name": "string", 
    "account_number": "string", 
    "bank_name": "string", 
}'

JavaScript

const options = {
  method: 'POST',
  headers: {
    accept: 'application/json',
    'ngnc-sec-key': 'NGNC_SECRET_KEY',
    'content-type': 'application/json'
  },
  body: JSON.stringify({
    "business_id": "string",  
    "link_tag": "string", 
    "type": "string", 
    "amount": 0,  
    "account_name": "string", 
    "account_number": "string", 
    "bank_name": "string", 
    "network": "string",
    "wallet_address": "string"
  });
};

fetch('https://api.ngnc.online/transactions/v1/offramp', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Python

python -m pip install requests

import requests

url = "https://api.ngnc.online/transactions/v1/offramp"

payload = {
    "business_id": "string",  
    "link_tag": "string", 
    "type": "string", 
    "amount": 0,  
    "account_name": "string", 
    "account_number": "string", 
    "bank_name": "string", 
    "network": "string",
    "wallet_address": "string"
}
headers = {
    "accept": "application/json",
    "ngnc-sec-key": "NGNC_SECRET_KEY",
    "content-type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Parameter	Type	Description	Required
business_id	String	Buinesses unique ID which can be found on the dashboard at app.ngnc.online.	True
link_tag	String	Your business link_tag. Also provided on your dashbaord.	True
type	String	sell_ramp	True
amount	String	Amount user wishes to off-ramp and send to nigerian account. (Min 20 USDT / USDC)	True
account_name	String	Bank account name to deposit funds in Nigeria.	True
account_number	String	10 Digits Bank account number to deposit funds in Nigeria.	True
bank_name	String	Use the List Banks ENDPOINT to fetch the list of supported payment banks. Only the name needs to be passed	True

// Sample Sell Request in Javascript

const options = {
  method: 'POST',
  headers: {
    accept: 'application/json',
    'ngnc-sec-key': 'NGNC_SECRET_KEY',
    'content-type': 'application/json'
  },
  body: JSON.stringify({
    "business_id": "560520123",  
    "link_tag": "Link_Eng", 
    "type": "sell_ramp", 
    "amount": 1000,  
    "account_name": "Jane Doe", 
    "account_number": "3330484773", 
    "bank_name": "Wema bank", 
  });
};

fetch('https://api.ngnc.online/transactions/v1/offramp', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Off Ramp NGNC

POST https://api.ngnc.online/transactions/v1/offramp

Headers

Name	Type	Description
ngnc-sec-key*	String	Get Key from Bridge App

Request Body

Name	Type	Description
business_id*	String	Get your business id from Bridge App
account_name*	String
link_tag*	String
amount*	Number
type*	String	use: sell_ramp
wallet_address*	String
network*	String
bank_name*	String
account_number*	String

200: OK Returns the successful transaction data

{
    "status": "success",
    "message": "Transaction Request successful",
    "transaction": {
        "transaction_id": "645c31fdedd472fb04b3be53",
        "business": {
            "business_id": "0123456789"
        },
        "type": "Sell",
        "reference": "64125118694",
        "amount": 102094,
        "account_name": "Tansi Jones",
        "account_number": "9480948372",
        "bank_name": "Wema bank",
        "link_tag": "Link_eng",
        "date_created": "May 11, 2023"
    }
}

401: Unauthorized This happens when you enter a wrong key

404: Not Found This happens when you you use a wrong or broken url