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.
