Transfers

Navigate the intricacies of digital transactions with Supesa. This page provides an in-depth look into the Supesa API endpoints tailored for sending payments, obtaining forex rates, and checking your payment history.

POST/network/payments/send-to-supatag

Send Payment to SupaTag

Execute payments to a recipient using their SupaTag.

Required Attributes

Name
access_token
Type
string
Description
Your unique Access Token
Name
user_id
Type
string
Description
Your unique User Id
Name
network_linked_acc_uuid
Type
string
Description
Network Linked Account UUID (Default: "primary")
Name
recipient_public_address
Type
string
Description
Recipient's Public Address
Name
amount
Type
float
Description
Amount to send
Name
payment_route
Type
string
Description
Route for the payment

Request

POST

/network/payments/send-to-supatag

curl -X POST https://api.supesa.io/network/payments/send-to-supatag \
  -H "content-type: application/json" \
  -d '{
      "access_token": "YOUR_ACCESS_TOKEN",
      "user_id": "YOUR_USER_ID",
      "network_linked_acc_uuid": "primary",
      "recipient_public_address": "RECIPIENT_PUBLIC_ADDRESS",
      "amount": AMOUNT_TO_SEND,
      "payment_route": "YOUR_PAYMENT_ROUTE"
    }'

Response

{
  "code": 200,
  "message": {},
  "ref": "some_reference_id"
}

GET/fx/rates

Get Forex Rates

Retrieve the exchange rate between two currencies.

Required Attributes

Name
fx_iso_base
Type
string
Description
Base currency ISO code
Name
fx_iso_quote
Type
string
Description
Quote currency ISO code

Request

GET

/fx/rates

curl -X GET https://api.supesa.io/fx/rates \
  -H "content-type: application/json" \
  -d '{
      "fx_iso_base": "YOUR_BASE_ISO",
      "fx_iso_quote": "YOUR_QUOTE_ISO"
    }'

Response

0.027112499999999998

GET/payments/history/view

View Payment History

Examine your past transactions on the platform.

Required Attributes

Name
access_token
Type
string
Description
Your unique Access Token
Name
user_id
Type
string
Description
Your unique User Id

Request

GET

/payments/history/view

curl -X GET https://api.supesa.io/payments/history/view \
  -H "content-type: application/json" \
  -d '{
      "access_token": "YOUR_ACCESS_TOKEN",
      "user_id": "YOUR_USER_ID"
    }'

Response

{
  "code": 200,
  "message": [
     {
      "id": 40,
      "created_at": "2023-10-18T15:36:19.402371+00:00",
      "sender_user_id": "bfcfd1fa-8a74-4727-87ce-fbeee2b536ab",
      "recipient_supatag": "everest",
      "tx_type": "mmo",
      "tx_crossborder": true,
      "tx_amount": 100,
      "tx_network_charge": 4,
      "sender_fx_iso": "DZD",
      "recipient_fx_iso": "NGN",
      "tx_network_charge_pc": 0.04,
      "recipient_user_id": "907513bc-84ec-4801-9c7c-bc1e984a432c",
      "recipient_amount": 319.40064545873673,
      "tx_fx_charge": 2,
      "total_tx_charge": 6,
      "sender_account_type": "mmo",
      "recipient_account_type": "mmo",
      "fx_rate": 3.3978792070078376,
      "sender_supatag": "lagos",
      "tx_fx_charge_pc": 0.02,
      "sender_account_uuid": "8c5d7aaa-976b-48df-829d-c027a7a56312",
      "recipient_account_uuid": "028f0e16-b4af-44ac-b14d-3bad144738e3",
      "recipient_route_identity": "everest",
      "recipient_route_endpoint": "8849",
      "routing_raw_string": "supesa"
    },
    {
      "id": 41,
      "created_at": "2023-10-18T15:36:31.682238+00:00",
      "sender_user_id": "bfcfd1fa-8a74-4727-87ce-fbeee2b536ab",
      "recipient_supatag": "everest",
      "tx_type": "mmo",
      "tx_crossborder": true,
      "tx_amount": 100,
      "tx_network_charge": 4,
      "sender_fx_iso": "DZD",
      "recipient_fx_iso": "NGN",
      "tx_network_charge_pc": 0.04,
      "recipient_user_id": "907513bc-84ec-4801-9c7c-bc1e984a432c",
      "recipient_amount": 319.40064545873673,
      "tx_fx_charge": 2,
      "total_tx_charge": 6,
      "sender_account_type": "mmo",
      "recipient_account_type": "mmo",
      "fx_rate": 3.3978792070078376,
      "sender_supatag": "lagos",
      "tx_fx_charge_pc": 0.02,
      "sender_account_uuid": "8c5d7aaa-976b-48df-829d-c027a7a56312",
      "recipient_account_uuid": "028f0e16-b4af-44ac-b14d-3bad144738e3",
      "recipient_route_identity": "everest",
      "recipient_route_endpoint": "8849",
      "routing_raw_string": "supesa"
    }
  ],
  "ref": "07dc64c3-a7b6-4fe7-a3ff-5d17d81172b4"
}