Skip to main content
Français Italiano Português

HiPay Marketplace – Cash-out – Creation of a seller account

You will find hereafter the necessary technical information to create a seller account.   

For more details, please refer to this documentation.

Service endpoints

Environment Endpoint
Stage https://test-merchant.hipaywallet.com/api/user-account.json
Production https://merchant.hipaywallet.com/api/user-account.json

 

Request parameters

Field Format Req. Description
credential[wslogin] AN M API login of the technical account, provided by your technical account manager
credential[wspassword] AN M API password of the technical account, provided by your technical account manager
email AN M Seller’s email address: it must be unique.
login AN M Seller’s login ID: it must be unique (it can be an email address).
Controle_type A M Value to send: "CREDENTIALS"
firstname A M First name of the account holder
lastname A M Last name of the account holder
currency A M Account currency. E.g.: 'EUR', 'USD'
locale AN M Account language. E.g.: 'fr_FR', 'en_EN'
civility N   By default, the field is set to '1'.
  • 1 = Mr.
  • 2 = Mrs.
  • 3 = Miss
merchant_group_code N M Merchant group code, provided by your technical account manager
entity_code A M Merchant group alias, provided by your technical account manager
account_type N   Value to send: '1' for Professional
pro_type N   By default, the field is set to '1'.
  • 1 = Corporation
  • 2 = Person
  • 3 = Association
company_name AN M Name of the company
address[address] AN M Address of the account holder
address[zipcode] AN M Postal code. E.g: '75003'
address[city] AN M City
address[country] AN M Country
timezone AN   By default: 'Europe/Paris'
birthdate AN M Date of birth of the account holder

 

API request example

{
"credential[wslogin]":"aa9bexxxxxxxxxxba26de19",
"credential[wspassword]":"8e9e030xxxxxxxxxxxe0b0",
"email":"johndoe@mail.com",
"login":"johndoe@mail.com",
"controle_type": "CREDENTIALS",
"firstname":"John",
"lastname":"Doe",
"currency":"EUR",
"locale":"fr_FR",
"civility":"1",
"merchant_group_id":"250",
"entity_code":"merchanttest",
"account_type":"1",
"pro_type":"1",
"company_name":"company",
"address[address]":"6 place du Colonel Bourgoin",
"address[zipcode]":"75012",
"address[city]":"Paris",
"address[country]":"FR",
"timezone":"Europe/Paris",
"birthdate":"1965-11-12"
}

 

API response example

{
"code":0,
"message":"The merchant account [mail=johndoe@mail.com] has been added at entity [code = merchanttest] in merchant group [id= 250 ] ",
"email":"johndoe@mail.com",
"wslogin":"43159c5dxxxxxxxxxxxxxxf722f663",
"wspassword":"be314a808912xxxxxxxxxxxxx736b81",
"status":1,
"account_id":760667,
"user_space_id":286521,
"callback_salt":"9xc0f26t"
}

 

Once the seller account has been created, it must be identified in order for you to be able to make transfers and withdrawals.

To this end, please refer to the articles on how to send KYC/KYB documents and bank information.

After completing these two steps, you will receive a notification informing you of the status of the account identification. For more details about notifications, please refer to this article.

Related articles