Intégration simple et facile

Notre kit d'intégration vous permet d'accepter le paiement en espèces et de bénéficier d'un réseau de plus de 1000 agences wafacash en quelques heures.

Binga.ma

Intégration par API

Nous recommandons l'utilisation de l'un de nos SDKs pour faire des appels de notre API. Vous trouvez ci-dessous le code démonstratif de la manière d'appel de l'API en utilisent nos SDKs.

  • cURL
  • PHP
  • Java
$ curl https://api.binga.ma/api/orders/000011496845 \
	-H "Authorization: Basic 8a19aff55b85a436dad5cd1386db1999437" \
	-H "Accept: application/json" 
		
<?php
    // Binga PHP SDK
    require 'Binga.php';

	/*
	 * IS_PRODUCTION = TRUE/FALSE
	 * MERCHANT_ID = Votre ID
	 * MERCHANT_SECRET = Votre code secret
	 */
    BingaApi::BingaKey(IS_PRODUCTION,MERCHANT_ID,MERCHANT_SECRET);
    $Binga = new BingaApi();
	$response = $Binga->request('api/orders',array(
		'code' => '000011496845'
	));

    // display the response
    print_r($response);
?>
/*
 * is_production = true/false
 * merchant_id = Votre ID
 * merchant_secret = Votre code secret
 */
BingaKey bingaKey = new BingaKey(is_production, merchant_id, merchant_secret);
BingaApi api = new BingaApi(bingaKey);
OrderSearchRequest req = new OrderSearchRequest("000011496845");	
Order order = api.execute( req );

Si vous utilisez un langage n'est pas pris en charge par l'un de nos kits de développement logiciel, vous pouvez effectuer des appels d'API en faisant des requêtes HTTP vers API Endpoints.

Facturer un client

La facturation d'un client s'effectue en appelant /orders/pay.

Appel API:

Paramètre Déscription
externalId Identifiant de la commande auprès du marchand
expirationDate Date d'expiration de la commande
amount Montant total de la commande
buyerFirstName Prénom de l'acheteur
buyerLastName Nom de l'acheteur
buyerEmail Email de l'acheteur
buyerAddress Adresse de l'acheteur
buyerPhone Téléphone de l'acheteur
storeId Identifiant du magasin
successUrl URL où aller si la commande est créé avec succès
failureUrl URL où aller en cas d'échèc de la création de la commande
bookUrl URL de la mise à jour de la commande marchand (PENDING)
payUrl URL de la mise à jour de la commande marchand (PAID)
orderCheckSum C'est un code qui permet de vérifier la source et l'integrité de la commande
  • cURL
  • PHP
  • Java
$ curl https://api.binga.ma/api/orders/pay \
	-H "Authorization: Basic 8a19aff55b85a436dad5cd1386db1999437" \
	-H "Accept: application/json" \
	-d "externalId=00000010" \
	-d "expirationDate=2013-12-01T19:20:30GMT" \
	-d "amount=3400" \
	-d "buyerFirstName=Souad" \
	-d "buyerLastName=Bahraoui" \
	-d "buyerEmail=s.bahraoui@live.fr" \
	-d "buyerAddress=11, BD de la résitance, Casablanca" \
	-d "buyerPhone=0661000000" \
	-d "storeId=1" \
	-d "successUrl=url1" \
	-d "failureUrl=url2" \
	-d "payUrl=url3" \
	-d "bookUrl=url4" \
	-d "orderCheckSum=checksum"
<?php
	// Binga PHP SDK 
	require 'Binga.php';
	/*
	 * IS_PRODUCTION = TRUE/FALSE
	 * MERCHANT_ID = Votre ID
	 * MERCHANT_SECRET = Votre code secret
	 */
	BingaApi::BingaKey(IS_PRODUCTION,MERCHANT_ID, MERCHANT_SECRET);
	$Binga = new BingaApi();
	$response = $Binga->request('api/orders/pay',array(
		'externalId'=>'00000010',
		'expirationDate'=>'2013-12-01T19:20:30GMT',
		'amount'=>'3400',
		'buyerFirstName'=>'Souad',
		'buyerLastName'=>'Bahraoui',
		'buyerEmail'=>'s.bahraoui@live.fr',
		'buyerAddress'=>'11, BD de la résitance, Casablanca',
		'buyerPhone'=>'0661000000',
		'storeId'=>'1',
		'successUrl'=>'url1',
		'failureUrl'=>'url2',
		'payUrl'=>'url3',
		'bookUrl'=>'url4',
		'orderCheckSum'=>'checksum',
	));

	// display the response
	print_r($response);
?>
/*
 * is_production = true/false
 * merchant_id = Votre ID
 * merchant_secret = Votre code secret
 */
BingaKey bingaKey = new BingaKey(is_production, merchant_id, merchant_secret);
BingaApi api = new BingaApi(bingaKey);
OrderPayRequest req = new OrderPayRequest("1","00000010","2013-12-01T19:20:30GMT","3400","Souad","Bahraoui","s.bahraoui@live.fr","11, BD de la résitance, Casablanca","0661000000","url1","url2","url3","url4","checksum");
order = api.execute(req);		

Réponse:

Réponse Description
amount Montant total de la commande
bookUrl URL de la mise à jour de la commande marchand (PENDING)
buyerAddress Adresse de l'acheteur
buyerEmail Email de l'acheteur
buyerFirstName Prénom de l'acheteur
buyerLastName Nom de l'acheteur
buyerPhone Téléphone de l'acheteur
code Code de la commande
creationDate Date de création de la commande
expirationDate Date d'expiration de la commande
externalId Identifiant de la commande auprès du marchand
failureUrl URL où aller en cas d'échèc de la création de la commande
id Id de la commande
payUrl URL de la mise à jour de la commande marchand (PAID)
serviceCharge Frais de service
stampDuty Droits de timbre
status Status de la commande
store Détails du magasin
successUrl URL où aller si la commande est créé avec succès
totalAmount Montant total à payer

Xml réponse:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response>
    <result>success</result>
    <orders>
        <order>
            <amount>3400</amount>
            <bookUrl>url4</bookUrl>
            <buyerAddress>11, BD de la résitance, Casablanca</buyerAddress>
            <buyerEmail>s.bahraoui@live.fr</buyerEmail>
            <buyerFirstName>Souad</buyerFirstName>
            <buyerLastName>Bahraoui</buyerLastName>
            <buyerPhone>0661000000</buyerPhone>
            <code>000045960693</code>
            <creationDate>2013-02-01T10:30:30GMT</creationDate>
            <expirationDate>2013-12-01T10:30:30GMT</expirationDate>
            <externalId>00000010</externalId>
            <failureUrl>url2</failureUrl>
            <id>66</id>
            <payUrl>url3</payUrl>
            <serviceCharge>0.0</serviceCharge>
            <stampDuty>0.0</stampDuty>
            <status>PENDING</status>
            <store>
                <id>4</id>
                <merchant>
                    <address>Adress</address>
                    <category>
                        <code>63</code>
                        <id>2</id>
                        <name>medium</name>
                    </category>
                    <city>Casablanca</city>
                    <code>599</code>
                    <email>email</email>
                    <id>11</id>
                    <image>urlLogo</image>
                    <MStatus>1</MStatus>
                    <name>merchantName</name>
                    <phone>0522111111</phone>
                    <rc>RC1000</rc>
                    <website>www.website.ma</website>
                </merchant>
                <name>StoreName</name>
                <salesCount>0</salesCount>
            </store>
            <storeOrderNumber>0</storeOrderNumber>
            <successUrl>url1</successUrl>
            <totalAmount>0.0</totalAmount>
        </order>
    </orders>
</response>

Json réponse:

{
  "response": {
    "result": "success",
    "orders": {
      "order": {
        "amount": "3400.0",
        "bookUrl": "url4",
        "buyerAddress": "11, BD de la résitance, Casablanca",
        "buyerEmail": "s.bahraoui@live.fr",
        "buyerFirstName": "Souad",
        "buyerLastName": "Bahraoui",
        "buyerPhone": "0661000000",
        "code": "000045960693",
        "creationDate": "2013-02-01T10:30:30GMT",
        "expirationDate": "2013-12-01T10:30:30GMT",
        "externalId": "00000010",
        "failureUrl": "url2",
        "id": "66",
        "payUrl": "url3",
        "serviceCharge": "0.0",
        "stampDuty": "0.0",
        "status": "PENDING",
        "store": {
          "id": "4",
          "merchant": {
            "address": "Adress",
            "category": {
              "code": "63",
              "id": "2",
              "name": "medium"
            },
            "city": "Casablanca",
            "code": "599",
            "email": "email",
            "id": "11",
            "image": "urlLogo",
            "MStatus": "1",
            "name": "merchantName",
            "phone": "0522111111",
            "rc": "RC1000",
            "website": "www.website.ma"
          },
          "name": "StoreName",
          "salesCount": "0"
        },
        "storeOrderNumber": "0",
        "successUrl": "url1",
        "totalAmount": "0.0"
      }
    }
  }
}

  Acceptez dès aujourd'hui le paiement en espèces.

Boostez votre chiffre d'affaires en s'addressant à une clientéle plus large.