API Card Charging

API Card Charging

Chat with AI▼

Endpoint: /v1/services/card_charging?api_key=YOUR_API_KEY

Method: POST

Header: How to generate JWT_TOKEN

{
    "X-APPOTAPAY-AUTH": "Bearer JWT_TOKEN",
    "Content-Type": "application/json"
}

Params

Params	Required	Type	Description
code	√	String	Card code is encrypted
serial	√	String	Card Serial
vendor	√	String	Default is: appota
partner_code	√	String	Partner code is provided by AppotaPay
service_name	√	String	Partner service name
transaction_id	√	String	Unique ID per transaction (5 - 50 char)
signature	√	String	Hash params: signature= SHA256(code + serial + vendor + partner_code + service_name + transaction_id + secret_key) Secret key is provided by AppotaPay

Data result

Params	Type	Description
error_code	String	Error Code
message	String	Error Message
data	Object	Response data
data.amount	Integer	Card value
data.serial	String	Card serial
data.transaction_id	String	AppotaPay Transaction ID
data.time	String	Transaction Time

Example

Response

{
    "error_code": "00",
    "message": "Transaction success",
    "data": {
        "amount": 100000,
        "serial": "OTA123456789",
        "transaction_id": "abc123",
        "time": "10:05:01 08/05/2019 GMT+7"
    }
}

Code Examples

curl --location 'https://gateway.dev.appotapay.com/v1/services/card_charging?api_key=YOUR_API_KEY' \
  --header 'X-APPOTAPAY-AUTH: JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  -d '{
  "code": "encrypted_card_code",
  "serial": "OTA123456789",
  "vendor": "appota",
  "partner_code": "PARTNER_CODE",
  "service_name": "TEST",
  "transaction_id": "unique_transaction_id_12345",
  "signature": "calculated_signature_hash"
}'

Request

REQUEST

Base URL

https://gateway.dev.appotapay.com

Development server

Path

Auth REQUIRED

Bearer Token

Parameters

api_key — query REQUIRED

Body REQUIRED

Example (from schema)

{ "code": "encrypted_card_code", "serial": "OTA123456789", "vendor": "appota", "partner_code": "PARTNER_CODE", "service_name": "TEST", "transaction_id": "unique_transaction_id_12345", "signature": "calculated_signature_hash" }