πͺAPI
This is an API that interacts with the POS25 system.
Base url: https://api.pos25.app/v1/cf-payment
Token:
8d1300ea96d3cca64918f871318864c6
. Developer can using this Token to test the APIs bellow.
1. Get list chain support
GET
https://api.pos25.app/v1/cf-payment/chain
The API will respond list of blockchain that POS25 support. Information includes name, chain_id, and link logo.
Headers
Authorization*
String
Bearer <Token>
{
"data": [
{
"name": "SCROLL",
"chain_id": 534352,
"logo": "https://s2.coinmarketcap.com/static/img/coins/64x64/26998.png"
},
{
"name": "NAUTILUS",
"chain_id": 22222,
"logo": "https://pbs.twimg.com/profile_images/1626750544642727937/qNCwFLUt_400x400.jpg"
},
{
"name": "BASE",
"chain_id": 8453,
"logo": "https://bridge.base.org/icons/base.svg"
},
{
"name": "SUI",
"chain_id": 101,
"logo": "https://static.atomsolution.vn/sui.png"
}
],
"errors": [],
"msg": "",
"error_code": ""
}
Let's see how you can call this method either through Curl
or Python
:
curl --location 'https://api.pos25.app/v1/cf-payment/chain' \
--header 'Authorization: Bearer 8d1300ea96d3cca64918f871318864c6'
2. Get a list of asset support
GET
https://api.pos25.app/v1/cf-payment/asset
The API will retrieve a list of chain assets that the user passes in via chain_id
Query Parameters
chain_id*
String
chain_id that pos25 supports
Headers
Authorization*
String
Bearer <Token>
{
"data": [
{
"asset": "USDT",
"chain": "SCROLL",
"chain_id": 534352,
"decimal": 6,
"logo": "https://s3.ap-southeast-1.amazonaws.com/static.atomsolution.vn/usdt.png"
}
],
"errors": [],
"msg": "",
"error_code": ""
}
Let's see how you can call this method either through Curl
or Python
:
curl --location 'https://api.pos25.app/v1/cf-payment/asset?chain_id=534352'
3. API create link payment (Support QR code)
POST
https://api.pos25.app/v1/cf-payment/generate_qr
The API generates link payment. You can generate a QR code from the link and Users can make payments on wallets such as Metamask, TRAM wallet,...
Headers
Authorization*
String
Bearer <Token>
Request Body
order_id*
String
Order id of transaction (UNIQUE)
amount*
String
Transaction amount
asset*
String
the asset the user wants to pay (the asset is taken from the API to get a list of supported assets)
chain_id*
String
chain_id is the blockchain the user wants to pay on, obtained from the supporting chain API
currency*
String
the currency the user wants to display instead of the blockchain asset (with added transaction fees)
fee_value*
String
Transaction fee
serial_number*
String
serrial number of POS device
{
"data": {
"qr_url": "https://app.pos25.app/qr-scan?&order_id=010001&contract_address=0x48736b8AC81E0fa279b571B25C698D631a4407A1¤cy_address=0x55d398326f99059ff775485246999027b3197955&transaction_amount=0.001&act=DEPOSIT&chain_id=22222&decimal=6",
"rate_usd": 23000,
"expire_at": "04/11/2023 22:50:31"
},
"errors": [],
"msg": "",
"error_code": ""
}
Let's see how you can call this method either through Curl
or Python
:
curl --location 'https://api.pos25.app/v1/cf-payment/generate_qr' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 8d1300ea96d3cca64918f871318864c6' \
--data '
{
"order_id": "010001",
"amount": "0.001",
"asset": "USDT",
"chain_id": 22222,
"currency": "USD",
"fee_value": "0",
"serial_number": "00024500706"
}
'
4. API NFC payment
POST
https://api.pos25.app/v1/cf-payment/generate_nfc
The API performs the above payment using NFC
*NOTE: Currently, payment by NFC is only supported on TRAM wallet
Headers
Authorization*
String
Bearer <Token>
Request Body
order_id*
String
Order id of transaction (UNIQUE)
amount*
String
Transaction amount
token*
String
The token will be created by TRAM wallet to request a transaction and sent to the POS machine via NFC
serial_number*
String
serrial number of POS device
{
"data": "success",
"errors": [],
"msg": "",
"error_code": ""
}
Let's see how you can call this method either through Curl
or Python
:
curl --location 'https://api.pos25.app/v1/cf-payment/generate_nfc' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 8d1300ea96d3cca64918f871318864c6' \
--data '{
"token": "10f932e3-b85a-4c23-8a88-f830e4bbfe06",
"order_id": "92108",
"amount": "0.01",
"serial_number": "00024500710"
}
'
Last updated