table {
  display: table !important;
}

.table-scroll {
  overflow: scroll;
}

table tbody tr:nth-child(odd) {
  background: #FAFAFA;
}

html.dark table tbody tr:nth-child(odd) {
  background: #1A1A1A;
}


/**
 * Minified by jsDelivr using Terser v5.15.1.
 * Original file: /npm/mermaid@10.1.0/dist/arc-f7872e1e.js
 *
 * Do NOT use SRI with dynamically generated files! More information: https://www.jsdelivr.com/using-sri-with-dynamic-files
 */
import{c as V,p as sn}from"./constant-2fe7eae5.js";import{O as en,P as Z,Q as O,R as rn,T as y,K as ln,V as z,W as b,X as un,Y as t,Z as an,_ as on,$ as tn}from"./utils-8ea37061.js";function fn(n){return n.innerRadius}function cn(n){return n.outerRadius}function yn(n){return n.startAngle}function gn(n){return n.endAngle}function mn(n){return n&&n.padAngle}function pn(n,t,r,c,e,a,u,o){var i=r-n,l=c-t,f=u-e,s=o-a,p=s*i-f*l;if(!(p*p<y))return[n+(p=(f*(t-a)-s*(n-e))/p)*i,t+p*l]}function H(n,t,r,c,e,y,a){var u=n-r,o=t-c,i=(a?y:-y)/z(u*u+o*o),l=i*o,f=-i*u,s=n+l,p=t+f,x=r+l,h=c+f,g=(s+x)/2,v=(p+h)/2,d=x-s,m=h-p,O=d*d+m*m,V=e-y,T=s*h-x*p,Z=(m<0?-1:1)*z(tn(0,V*V*O-T*T)),R=(T*m-d*Z)/O,A=(-T*d-m*Z)/O,H=(T*m+d*Z)/O,b=(-T*d+m*Z)/O,j=R-g,P=A-v,K=H-g,Q=b-v;return j*j+P*P>K*K+Q*Q&&(R=H,A=b),{cx:R,cy:A,x01:-l,y01:-f,x11:R*(e/V-1),y11:A*(e/V-1)}}function hn(){var n=fn,r=cn,c=V(0),e=null,a=yn,u=gn,o=mn,i=null;function l(){var l,f,s=+n.apply(this,arguments),p=+r.apply(this,arguments),x=a.apply(this,arguments)-rn,h=u.apply(this,arguments)-rn,g=un(h-x),v=h>x;if(i||(i=l=sn()),p<s&&(f=p,p=s,s=f),p>y)if(g>ln-y)i.moveTo(p*Z(x),p*O(x)),i.arc(0,0,p,x,h,!v),s>y&&(i.moveTo(s*Z(h),s*O(h)),i.arc(0,0,s,h,x,v));else{var d,m,V=x,T=h,R=x,A=h,j=g,P=g,K=o.apply(this,arguments)/2,Q=K>y&&(e?+e.apply(this,arguments):z(s*s+p*p)),W=b(un(p-s)/2,+c.apply(this,arguments)),X=W,Y=W;if(Q>y){var $=an(Q/s*O(K)),_=an(Q/p*O(K));(j-=2*$)>y?(R+=$*=v?1:-1,A-=$):(j=0,R=A=(x+h)/2),(P-=2*_)>y?(V+=_*=v?1:-1,T-=_):(P=0,V=T=(x+h)/2)}var k=p*Z(V),q=p*O(V),w=s*Z(A),B=s*O(A);if(W>y){var C,D=p*Z(T),E=p*O(T),F=s*Z(R),G=s*O(R);if(g<en&&(C=pn(k,q,F,G,D,E,w,B))){var I=k-C[0],J=q-C[1],L=D-C[0],M=E-C[1],N=1/O(on((I*L+J*M)/(z(I*I+J*J)*z(L*L+M*M)))/2),S=z(C[0]*C[0]+C[1]*C[1]);X=b(W,(s-S)/(N-1)),Y=b(W,(p-S)/(N+1))}}P>y?Y>y?(d=H(F,G,k,q,p,Y,v),m=H(D,E,w,B,p,Y,v),i.moveTo(d.cx+d.x01,d.cy+d.y01),Y<W?i.arc(d.cx,d.cy,Y,t(d.y01,d.x01),t(m.y01,m.x01),!v):(i.arc(d.cx,d.cy,Y,t(d.y01,d.x01),t(d.y11,d.x11),!v),i.arc(0,0,p,t(d.cy+d.y11,d.cx+d.x11),t(m.cy+m.y11,m.cx+m.x11),!v),i.arc(m.cx,m.cy,Y,t(m.y11,m.x11),t(m.y01,m.x01),!v))):(i.moveTo(k,q),i.arc(0,0,p,V,T,!v)):i.moveTo(k,q),s>y&&j>y?X>y?(d=H(w,B,D,E,s,-X,v),m=H(k,q,F,G,s,-X,v),i.lineTo(d.cx+d.x01,d.cy+d.y01),X<W?i.arc(d.cx,d.cy,X,t(d.y01,d.x01),t(m.y01,m.x01),!v):(i.arc(d.cx,d.cy,X,t(d.y01,d.x01),t(d.y11,d.x11),!v),i.arc(0,0,s,t(d.cy+d.y11,d.cx+d.x11),t(m.cy+m.y11,m.cx+m.x11),v),i.arc(m.cx,m.cy,X,t(m.y11,m.x11),t(m.y01,m.x01),!v))):i.arc(0,0,s,A,R,v):i.lineTo(w,B)}else i.moveTo(0,0);if(i.closePath(),l)return i=null,l+""||null}return l.centroid=function(){var t=(+n.apply(this,arguments)+ +r.apply(this,arguments))/2,c=(+a.apply(this,arguments)+ +u.apply(this,arguments))/2-en/2;return[Z(c)*t,O(c)*t]},l.innerRadius=function(t){return arguments.length?(n="function"==typeof t?t:V(+t),l):n},l.outerRadius=function(n){return arguments.length?(r="function"==typeof n?n:V(+n),l):r},l.cornerRadius=function(n){return arguments.length?(c="function"==typeof n?n:V(+n),l):c},l.padRadius=function(n){return arguments.length?(e=null==n?null:"function"==typeof n?n:V(+n),l):e},l.startAngle=function(n){return arguments.length?(a="function"==typeof n?n:V(+n),l):a},l.endAngle=function(n){return arguments.length?(u="function"==typeof n?n:V(+n),l):u},l.padAngle=function(n){return arguments.length?(o="function"==typeof n?n:V(+n),l):o},l.context=function(n){return arguments.length?(i=n??null,l):i},l}export{hn as d};
//# sourceMappingURL=/sm/011074e88455cc12e6c541a23fa79632dda39aa8159b71cb430e6dae23601db0.map


Sandbox MSISDN

HUB2 Documentation

HUB2

Integration

Intégration

Documentation

API Reference

Home

Accueil

A guide to help getting started with HUB2 API integration

Introduction

API Operation

Security

Understand errors

API keys

Failure causes

MSISDN - Blacklist

Authentication

List payments

Object samples

List of available events

Webhooks behavior

Best practices

Samples

Balances

Account Provisioning

Public data

Bank collection

Recipients

Payload signature

Un guide pour commencer à intégrer l'API HUB2

Fonctionnement de l'API

Sécurité

Comprendre les erreurs

Clés API

Motifs d'échec

MSISDN - Liste noire

MSISDN en sandbox

Authentification

Lister les paiements

Exemples d'objets

Liste des évènements disponibles

Comportement des webhooks

Les bonnes pratiques

Échantillons

Soldes

Approvisionnement de compte

Données publiques

Collecte bancaire

Destinataires

Signature des données

Definition of useful terms used in HUB2's payment platform

Glossary

Rate limits

Policies

Error management

Glossaire

Ce sont les limites appliquées sur notre API.

Limites de flux

Règles

Gestion des erreurs

Returns the list of countries where Hub2 is available

Get countries

Returns the list of providers available with Hub2

Get providers

Returns a summary of a merchant accounts balances (collection, transfer and transfer irt accounts) .

Check Merchant Balance

Get all webhooks

Create a webhook

Get a webhook

Remove a webhook

Update a webhook

Retrieve number of sms sent between two date

Retrieve number of sms sent

Retrieve a list of sms sent between two date.

Get a list of sms sent

Send Sms

This endpoints is here to provide you an efficient way of retrieving multiple payment intents at the same time.
    Everything is provided in the request's headers to perform a proper pagination on the results.

Retrieve a PaymentIntent collection

This endpoint is the first entry point of the PAY-IN circuit.
    First of all, you must create a payment intent which describes your intention to collect an amount of money in a currency.
    Later on, you will perform payments associated with this payment intent.
    Please do save the fields returned by this endpoint, especially the field 'id' and 'token'.
    That will help you identity the payment intent in our platform whenever you want to retrieve it.

Create a PaymentIntent object

This endpoint allows you to fetch an existing payment intent from our database.
    You must either provide the "id" or the "token" for us to find that payment intent.
    Retrieving using the "token" is the fastest way and is not rate limited, depending on your needs, that's probably the best solution.

Retrieve a PaymentIntent object

This is the endpoint to use whenever you want to attempt a payment on a payment intent.
    It will create a payment object associated with the intent which will contains all the informations about the payment.
    Whenever a payment fails or don't have the appropriate amount to match the intent, other payments can be created on the same intent.

Attempt a payment on a PaymentIntent object

This is the same endpoint but the payment is handled synchronously, it means it will wait for the provider response before returning the status of the payment intent. This endpoint is not the favored way to integrate our api and is not available for all merchants and for all providers.

Synchronously attempt a payment on a payment intent

Some circuit have authentication restrictions which requires an extra step.
    This endpoint is here to allow you to make that extra steps. It happens after a payment has been requested and when that payment moved to the "action_required" state.

Authenticate the current payment

This endpoint allows you to retrieve the fees associated with a payment intent.
    Fees are applied per payment and this endpoints will group all the fees in an array.

Retrieve fees

This endpoint fetch the merchant's preference and return the redirection URL saved in there.
    This is mostly used for the Hub2 modal feature.
    You must provide the payment intent token for that.

Retrieve configured URLs

This endpoint allows you to fetch the status of an existing payment intent from our database.
    You must either provide the "id" or the "token" for us to find that payment intent.
    Retrieving using the "token" is the fastest way and is not rate limited, depending on your needs, that's probably the best solution.

Retrieve a PaymentIntent status

Return a list of Payments, eventually filtered by criteria.

Retrieve a Payments collection

Retrieve the status payment object

Retrieve a Provisionings collection

Move funds from merchant's collection account to transfer account

Create a Provisioning

Retrieve a Provisioning from given id

Retrieve a sucessful or failed transfer or payment receipt

Retrieve a Receipt

Retrieve a sucessful or failed transfer or payment receipt as HTML

Retrieve a Receipt as an HTML representation

Execute payment

Retrieve a payment

Return a list of IRT transfers, eventually filtered by criteria.

Retrieve a IRT transfers collection

Create IRT transfer

Return a list of Transfers, eventually filtered by criteria.

Retrieve a Transfer collection

This endpoint allows you to make a transfer (PAY-OUT)

Create Transfer

This endpoint allows you to fetch an existing transfer from our database
    by providing its 'id'

MSISDN	Code
00000001	successful
00000002	successful (with delay)
00000003	pending (blocked)
00000100	failed	`authentication_failed`
00000101	failed	`authentication_timeout`
00000200	failed	`unknown_reason`
00000201	failed	`customer_insufficient_funds`
00000202	failed	`customer_account_locked`
00000203	failed	`forbidden_by_provider`
00000204	failed	`bad_parameters`
00000205	failed	`payer_quota_exceeded`
00000206	failed	`invalid_amount`
00000211	failed	`canceled_by_customer`
00000300	failed	`timeout`
00000301	failed	`too_many_request`
00000302	failed	`service_unavailable`
00000303	failed	`internal_error`
00000304	failed	`wave_payment_expired`
00000305	failed	`duplicate_request`
00000400	failed	`invalid_msisdn`

Connector	00000001	00000002	00000003	00000100	00000101	00000200	00000201	00000202	00000203	00000204	00000205	00000206	00000211	00000300	00000301	00000302	00000303	00000304	00000305	00000400
mm_bf_moov	✔️	❌	❌	❌	✔️	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌
mm_bj_moov	✔️	❌	❌	❌	✔️	✔️	✔️	❌	❌	❌	❌	❌	❌	❌	❌	✔️	❌	❌	❌	❌
mm_bj_celtiis	✔️	❌	❌	❌	❌	❌	✔️	✔️	✔️	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌
mm_*_wave	✔️	❌	✔️	❌	❌	✔️	❌	❌	✔️	✔️	❌	❌	❌	❌	✔️	✔️	✔️	✔️	❌	✔️
mm_ci_moov	✔️	❌	❌	✔️	✔️	✔️	✔️	✔️	✔️	❌	❌	❌	❌	✔️	✔️	❌	❌	❌	❌	✔️
mm_ci_mtn	✔️	✔️	❌	✔️	✔️	✔️	✔️	✔️	✔️	❌	❌	❌	❌	✔️	✔️	❌	❌	❌	❌	✔️
mm_ci_orange	✔️	❌	❌	✔️	✔️	✔️	✔️	✔️	✔️	❌	❌	❌	❌	✔️	✔️	❌	❌	❌	❌	✔️
mm_sn_free	✔️	❌	✔️	❌	❌	✔️	✔️	✔️	❌	❌	❌	❌	❌	❌	❌	✔️	✔️	❌	❌	✔️
mm_sn_orange	✔️	❌	✔️	✔️	❌	✔️	✔️	❌	✔️	✔️	✔️	✔️	❌	❌	✔️	✔️	✔️	❌	✔️	✔️
mm_tg_moov	✔️	❌	❌	❌	❌	✔️	✔️	❌	✔️	❌	❌	❌	❌	❌	❌	❌	✔️	❌	✔️	❌

Getting started

Transfers

Payments

Webhooks

Other

Sandbox MSISDN