HiPay Marketplace - Cash-out server-to-server notifications

This XML notification informs you of the arrival of the funds on the technical account.
The following fields are to be taken into consideration:
operation = other_transaction
status = ok
account_id (value of the HiPay technical account)
Settlement_id = number of the payout file containing all the sales of a day

Server-to-server POST notification example:



    

     
     
      42108f62f0d13337623e9ac8888e12dd
      
      
      
       other_transaction
       
      
       ok
       
      
       2019-02-23
       
      11:04:07 UTC+0000 
      
       56cc3ca65706f195
       
      
       123456
       
      
       1000
       
      
       EUR
       
      SALES transactions: Batch 210001 02-23-2019 
      
       SALES
       
      
       210001
       
      
       02-23-2019

2.1. “document_validation” notification for the validation or rejection of a document

An XML notification informing you of the validation status for each document of a seller account is sent.
Six fields are to be taken into consideration:
operation = document_validation
status = ok / nok
message (reason of the rejection)
document_type
document_type_label
account_id (value of the HiPay seller account)

Server-to-server POST notification example:



    

     
     
      d9e43bb0a9b92aba4fb22eed4164a1f0
      
      
      
       document_validation
       
      
       nok
       
      
       Not a proof of address
       
      
       2019-02-29
       
      16:39:42 Europe/Paris+0200 
      
       2
       
      
       Proof of address
       
      
       1234567

2.2. “identification” notification for the validation of all documents

A final XML notification informing you that all the documents have been validated for a seller account is sent. Three fields are to be taken into consideration:
operation = identification
status =ok / nok
account_id (value of the HiPay seller account)

Server-to-server POST notification example:



    

     
     
      f7bff5bce16868b3daefbc93bd52902a
      
      
      
       identification
       
      
       ok
       
      
       2019-03-21
       
      13:56:40 UTC+0000 
      
       1232592

3.1. “document_validation” for the bank document

An XML notification informing you of the validation status of the bank account identification document (RIB/IBAN) of a seller account is sent.
Six fields are to be taken into consideration:
operation = document_validation
status = ok / nok
message (reason for validation or rejection)
document_type
document_type_label
account_id (value of the HiPay seller account)

Server-to-server POST notification example:



    

     
     
      d9e43bb0a9b92aba4fb22eed4164a1f0
      
      
      
       document_validation
       
      
       nok
       
      
       Verified except holder\’s first name
       
      
       2018-06-29
       
      16:39:42 Europe/Paris+0200 
      
       6
       
      
       Bank
       
      
       1232592/account_id>

3.2. “bank_info_validation” notification for encoded IBAN

This XML notification informs you of the status of the validation of a seller account’s banking information.
Three fields are to be taken into consideration:
operation = document_validation
status = ok / nok
account_id (value of the HiPay seller account)

Server-to-server POST notification example:



    

     
     
      a4314ce63fc0be37959d2ee358393bf2
      
      
      
       bank_info_validation
       
      
       ok
       
      
       2018-07-29
       
      15:57:27 UTC+0000 
      
       1232592

4.1. Notification for electronic transfers

Two XML notifications inform you of the status of the electronic transfer validation. The following fields are to be taken into consideration:
operation = authorization or capture
status = ok / nok
account_id (value of the HiPay seller account)

Server-to-server POST notification example:



    

     
     
      0abbf2ab3b21019d153f8664c4b27771
      
      
      
       authorization
       
      
       ok
       
      
       2019-05-03
       
      14:10:22 UTC+0000 
      
       5909e4ccce294103
       
      
       1232592
       
      
       162.1
       
      
       EUR
       
      2090 aecf 232550



    

     
     
      b6434b8f37c85878f667d6dccecb1327
      
      
      
       capture
       
      
       ok
       
      
       2019-05-03
       
      14:10:25 UTC+0000 
      
       5909e4ccce294103
       
      
       1232592
       
      
       162.1
       
      
       EUR
       
      2090 aecf 232550

4.2. “withdraw_validation” notification for withdrawals

This XML notification informs you of the status of the validation or rejection of a withdrawal request to the seller’s or operator’s bank.
Three fields are to be taken into consideration:
operation = withdraw_validation
status = ok / nok (value for chargeback)
account_id = seller account ID

Server-to-server POST notification example:



    

     
     
      a4314ce63fc0be37959d2ee358393bf2
      
      
      
       withdraw_validation
       
      
       ok
       
      
       2019-05-03
       
      15:57:27 UTC+0000 
      
       5909e4ccce294103
       
      
       1232592