BillingPaymentsCrypto
BillingPaymentsCrypto
  • Introduction
    • 👋 Welcome
    • ▶️ What you need to operate
    • 🔑 Sandbox environment credentials
    • 🔧 Postman Collection
  • About us
    • 🌐 About us
    • ✨ Use cases
    • 🛡️ Security and data ownership
    • 💲 Pricing
  • Examples by country
  • API Reference
  • Webhooks
LogoLogo
API Reference🏢accounts

POST
https://api-billing.koywe.com/V1/accounts
POST
/V1/accounts
1curl -X POST https://api-billing.koywe.com/V1/accounts \
2 -H "Authorization: Bearer <token>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "country_id": 1,
6 "contact_name": "string",
7 "contact_phone": "string",
8 "admin_email": "string",
9 "admin_password": "string",
10 "registration_legal_name_company": "string",
11 "registration_tax_id_code": "string",
12 "registration_tax_id_type": "string",
13 "registration_company_size": "string",
14 "registration_terms_of_use": 1,
15 "registration_type_use": 1,
16 "registration_additional_data": {}
17}'
Try it
201Created
1{
2 "account_id": "638"
3}
Was this page helpful?
Previous

Get a specific account

Next
Built with
Create a new account

Authentication

AuthorizationBearer
Bearer authentication of the form `Bearer <token>`, where token is your auth token.

Request

This endpoint expects an object.
country_idintegerRequired

Country ID where the account is created, supported IDs are:
253 = Chile
89 = United States
66 = Colombia
80 = Mexico
83 = Perú

contact_namestringRequired
Contact name associated with the account that will be created.
contact_phonestringRequired

Contact phone associated with the account that will be created, format:
+56xxxxxxxxx = Chile
+1xxxxxxxxx = United States
+57xxxxxxxxxx = Colombia

admin_emailstringRequired

Admin email associated with the account that will be created.
Valid for login.

admin_passwordstringRequired

Admin password associated with the account that will be created.
Valid for login.

registration_legal_name_companystringRequired
Legal name of the company being registered.
registration_tax_id_codestringRequired

Tax ID code of the company being registered, format:
xx.xxx.xxx-x for Chile

registration_tax_id_typestringRequired

Tax ID type of the company being registered, supported IDs are:
CL-RUT = Chile RUT
US-EIN = United States EIN
US-SSN = United States SSN
CO-NIT = Colombia NIT
PE-RUC = Peru RUC
MX-RFC = Mexico RFC

registration_company_sizestringRequired

Size of the company being registered.
1 = Micro
2 = Small
3 = Medium
4 = Large

registration_terms_of_useintegerRequired

Acceptance of the terms of use.
1 = Accepted

registration_type_useintegerRequired

Type use of the accounts being registered, supported IDs are:
1 = Billing

registration_additional_dataobjectRequired
Required for certain countries. Check individual fields for more information
registration_company_industry_sectorstringOptional
Industry sector of the company being registered.
account_configobjectOptional

Response

Your account is successfully created
account_idinteger or null
Returns the ID of the created account.

Errors

Bearer authentication of the form Bearer <token>, where token is your auth token.