PosApp Open APIs
  1. Đăng ký tài khoản PosApp
PosApp Open APIs
  • Tổng quan
  • Thẻ PosApp
    • Mã lỗi (error code)
    • API Idempotency
    • Nạp tiền vào thẻ
      POST
    • Kiểm tra trạng thái giao dịch
      POST
  • Thông tin khác
    • Digital Signature
  • Webhook
    • Tổng quan
    • Order Schema
    • Warehouse import Schema
  • Sản phẩm
    • Tạo mới sản phẩm
      POST
    • Sửa một sản phẩm
      PATCH
    • Tồn kho sản phẩm
      POST
  • Khuyến mãi
    • Đồng giá
      • Tạo khuyến mãi
      • Sửa khuyến mãi
    • Xóa khuyến mãi
      POST
  • Đăng ký tài khoản PosApp
    • Danh sách mô hình kinh doanh
      GET
    • Đăng ký tài khoản
      POST
  1. Đăng ký tài khoản PosApp

Đăng ký tài khoản

Testing
Test Env
https://retail-api.posapp.vn/
Test Env
https://retail-api.posapp.vn/
POST
/api/public/partner-register
Lưu ý:
Đối tác cần liên hệ để PosApp cung cấp api-key để sử dụng trong header X-Api-Key
Rate limit: 10 request/minutes
Sau khi đăng ký tài khoản thành công, khách hàng sẽ nhận được tin nhắn qua ZALO (với số điện thoại đã đăng ký) thông tin đăng nhập để sử dụng phần mềm PosApp.

Request

Header Params
X-Api-Key
string 
required
Example:
<x-api-key-posapp>
Content-Type
string 
required
Example:
application/json
Body Params application/json
phone
string 
required
Số điện thoại khách hàng, lưu ý bắt đầu với +84xxxxxxxxx
shop_name
string 
required
Tên cửa hàng
main_type
integer 
required
ID loại mô hình kinh doanh tổng quát. Tham khảo DS mô hình kinh doanh (lấy key main_type)
business_type
integer 
required
ID loại mô hình kinh doanh chi tiết. Tham khảo DS mô hình kinh doanh (lấy key type trong children)
Example
{
	"phone": "+84323323453",
	"shop_name": "Shop test 1",
    "main_type": 2,
    "business_type": 4
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://retail-api.posapp.vn//api/public/partner-register' \
--header 'X-Api-Key: <x-api-key-posapp>' \
--header 'Content-Type: application/json' \
--data-raw '{
	"phone": "+84323323453",
	"shop_name": "Shop test 1",
    "main_type": 2,
    "business_type": 4
}'

Responses

🟢200Success
application/json
Body
response_time
integer 
required
Thời gian phản hồi với unix-timestamp
message
string 
required
Nội dung thông báo
result_code
integer 
required
Mã lỗi, thành công sẽ là 0
Example
{
    "response_time": 1749116392,
    "message": "Thành công",
    "result_code": 0
}
Modified at 2025-06-05 10:00:11
Previous
Danh sách mô hình kinh doanh
Built with