Callbacks list

Liste des callbacks

1. Callbacks list

All callbacks are sent in POST

Callback type Operation Example
1 Top-up by bank card type=1&id=CKPG&error=0&status=1&
userid=5e025b11-563482755c4dcb&userstatus=1
4 KYC Treatment by default :
type=4&id=75510&status=2&userid=
5a7yhc7e12-4198-61ao9-4y4ec-ce154c08&reason=Supporting documents inconsistent with clients data

Details
- type 4 = KYC request
- id = Request ID
- status = Request status
- userid = User appuserid
- reason = Reason for refusal
5 Registering bank card Example
type=5&id=card-1A9pRj46&error=0&userid=b47fszf-8485460-5f-94qqf7-e775f1sdd2

Details
- type 5 : Registering bank card
- id : Bank card appcardid
- error: ErrorCode
- userid = User account appuserid
7 Top-up by direct debit type=7&id=2dUr&error=0&status=1&
userid=8451c931-5479-98c2-3d4&userstatus=1
8 Top-up by bank transfer type=8&id=53389&error=0&status=1&
userid=574b-d709-884b-489b48e4627e&userstatus=1&
reference=sandbox.XMECS1
9 Mandate Example type=9&id=1989&error=0&status=1

Details
- type 9 : Mandate
- id : Mandate ID
- error : ErrorCode
- status : Mandate status
10 RIB Example type=10&id=180806&status=2&
userid=6d977711-d954-a092-4cc457&userstatus=6

Details
- type 10 : Bank account details
- id : Involved bank account ID
- status : 1 = validated, 2 = waiting for validation, 3=refused
- userid = User account appuserid
- userstatus : User account status
11 Return of funds for transfers type=11&id=payout_grs582&error=0&
status=2&userid=4826dghg&
userstatus=1

Détails
- type 11 : Return of funds for transfers
- id : OrderId of the transfer
- error : ErrorCode
- status : Payment status
2 = Refunded
(always equal to 2 in the case of a type 11 callback)
- userid : User account appuserid
- userstatus : User account status
12 Top-up by cheque type=12&id=256&error=0&status=0&
userid=wgqg-2815-dgsg&userstatus=1&
reference=Domaine.48854
14 Unpaid Example
type=14&id=25816&status=0&
userid=43584-gfegsdse-83-qfqf&reason=AM04&amount=166933

Details
- type 14 : unpaid operation
- id : orderid of the unpaid operation
- status : 0 = claim for payment (not regularized), 2 = closed
- userid = Account appuserid
- reason : Please refer to the chapter "Echecs, remboursements et notifications des prélèvements SEPA"
15 Account freeze or unfreeze Example
type=15&userstatus=1&userid=qgdw-45464-sgqgsgs
Details
- type 15: Account freeze or unfreeze
- userstatus : 1 = OK (unfrozen) / 2 = Frozen
- userid : user identifier "appUserId"
17 Refund Exemple
type=17&id=Refund-fpgdr7&error=0&status=0&initialOrderID=fpgdr7&userid=PRO&userstatus=1

Détails
- type 17 : Refund (Dalenys)
- id : OrderId of the refund transaction
- error : ErrorCode
- status : Always = 0
- initialOrderID : OrderId of the original operation
- userid : User account appuserid
- userstatus : User account status

2. Configuration of callbacks in your Backoffice (Espace Partenaire)

Your admin access allows you to configure callbacks, under this page: Configuration > Notifications
PNG
Here is the configuration that can be done:
- Paiement : all callback types unless they are configured below
- KYC: for all callbacks of type 4
- Prélèvement: for all callbacks of type 7
- Mandats: for all callbacks of type 9
- RIB: for all callbacks of type 10

You must tick "par défaut". If you don’t, the callback won’t be sent.