Frais de paiement

Pour obtenir les frais de paiement d'un code pays spécifique dans le système NoWallet, utilisez le point de terminaison suivant :

GET{baseUrl}/fees/by/country

note

De plus, la requête doit inclure le paramètre de requête country dans l'URL pour spécifier le code pays pour lequel vous souhaitez vérifier les frais de paiement. Par exemple, si vous souhaitez vérifier les frais de paiement pour le Cameroun, l'URL ressemblera à ceci :

{baseUrl}/fees/by/country?country=CM.

Request Parameters

Lors de la vérification des frais de paiement, la requête doit inclure les paramètres suivants dans l'URL :

Name	In	Type	Required	Description
country	query	string	true	Le code pays à vérifier

Exemples de Code dans Plusieurs Langages

Pour vous aider à intégrer l'API NoWallet facilement, nous fournissons des exemples de code dans divers langages de programmation. Ces exemples montrent comment effectuer une requête au point de terminaison de l'API et gérer la réponse.

• Shell (cURL) : Pour des tests rapides et une utilisation en ligne de commande.
• HTTP : Format brut de la requête HTTP pour comprendre la structure.
• JavaScript : En utilisant fetch pour les environnements de navigateur ou Node.js.
• Ruby : En utilisant la bibliothèque rest-client pour les applications Ruby.
• Python : En utilisant la bibliothèque requests pour les projets Python.
• PHP : En utilisant GuzzleHttp pour les intégrations PHP.
• Java : En utilisant HttpURLConnection pour les applications Java.
• Go : En utilisant le package net/http pour les projets Go.

Exemple de Requête

Voici un exemple de vérification des frais de paiement pour un code pays spécifique en utilisant différents langages. Sélectionnez l'onglet correspondant à votre langage préféré pour voir l'implémentation.

note

Assurez-vous de remplacer {access-token} par votre véritable jeton d'API et de fournir les paramètres requis dans la requête.

cURL

# Example cURL command to get payment fees
curl -X GET {baseUrl}/fees/by/country?country=string \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

HTTP

GET {baseUrl}/fees/by/country?country=string HTTP/1.1

Accept: application/json

JavaScript

const headers = {
  Accept: "application/json",
  Authorization: "Bearer {access-token}",
};

fetch("{baseUrl}/fees/by/country?country=string", {
  method: "GET",

  headers: headers,
})
  .then(function (res) {
    return res.json();
  })
  .then(function (body) {
    console.log(body);
  });

Ruby

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

result = RestClient.get '{baseUrl}/fees/by/country',
  params: {
  'country' => 'string'
}, headers: headers

p JSON.parse(result)

Python

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('{baseUrl}/fees/by/country', params={
  'country': 'string'
}, headers = headers)

print(r.json())

PHP

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'Bearer {access-token}',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','{baseUrl}/fees/by/country', array(
        'headers' => $headers,
        'json' => $request_body,
      )
    );
    print_r($response->getBody()->getContents());
}
catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
}

// ...

Java

URL obj = new URL("{baseUrl}/fees/by/country?country=string");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

Go

package main

import (
      "bytes"
      "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "{baseUrl}/fees/by/country", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Paramètres de la Réponse

La réponse de l'API inclura les paramètres suivants :

Statut	Signification	Description	Schéma
200	OK	Frais de paiement récupérée avec succès	En ligne
400	Bad Request	Erreurs possibles dans la requête	Aucun

Schéma de la Réponse

Pour le statut 200, la réponse inclura les champs suivants :

Name	Type	Required	Restrictions	Description
anonymous	[MerchantFeesDto]	false	none	none
» fee_cashin	number	true	none	frais cashin par pays et par opérateur
» fee_cashout	number	true	none	frais cashout par pays et par opérateur
» fee_merchant	number	true	none	frais marchand par pays et par opérateur
» country	string	true	none	code pays où les frais s'appliquent
» currency	string	true	none	code devise où les frais s'appliquent
» operator	string	true	none	opérateur où les frais s'appliquent
» rangefees	array	true	none	liste des plages de frais par pays

Types de Réponse

La réponse sera au format JSON et inclura les informations de frais de paiement pour le code pays spécifié.

Réponse de Succès (200 OK)

Exemple d'une réponse réussie avec les informations de frais de paiement pour le Cameroun.

{
  "fee_cashin": 2.1,
  "fee_cashout": 2.1,
  "fee_merchant": 2.1,
  "country": "CM",
  "currency": "XAF",
  "operator": "MTN",
  "rangefees": [
    {
      "min": 100,
      "max": 1000,
      "fee": 2.1
    }
  ]
}

Réponse d'Erreur (400 Bad Request)

Erreurs possibles pour une requête incorrecte

{
  "statusCode": 400,
  "error": "COUNTRY_CODE_NOT_FOUND",
  "message": "It seems that this country code does not exist or You can't perform this action, this token does not allow you"
}

Valeurs Énumérées

Les valeurs énumérées suivantes sont utilisées dans l'API :

• Method: La méthode de paiement peut être l'une des suivantes :
  • CASHIN: Représente une transaction d'entrée.
  • CASHOUT: Représente une transaction de sortie.
  • MERCHANT: Représente une transaction marchande.
• Country: Le code pays pour lequel les frais de paiement s'appliquent. Cela doit être un code pays ISO 3166-1 alpha-2 valide (par exemple, CM pour le Cameroun).

Ce tableau résume les valeurs énumérées utilisées dans l'API :

Propriété	Valeur
method	CASHIN
method	MERCHANT
method	CASHOUT
country	DZ
country	AO
country	BJ
country	BW
country	BF
country	BI
country	CM
country	CV
country	CF
country	TD
country	KM
country	CG
country	CD
country	CI
country	DJ
country	EG
country	GQ
country	ER
country	ET
country	GA
country	GM
country	GH
country	GN
country	GW
country	KE
country	LS
country	LR
country	LY
country	MG
country	MW
country	ML
country	MR
country	MU
country	YT
country	MA
country	MZ
country	NA
country	NE
country	NG
country	RE
country	RW
country	ST
country	SN
country	SC
country	SL
country	SO
country	ZA
country	SS
country	SD
country	SZ
country	TZ
country	TG
country	TN
country	UG
country	EH
country	ZM
country	ZW

Cette page vous a-t-elle été utile ?