Add VPA Scene API

Testing Env

https://testpay.onlinepay.ai

POST

/v2/card/addVpaScene

Create a VPA scene configuration that defines payment limits, time windows, and cycle settings for card transactions.

Request

Header Params

Body Params application/json

Example

{
    "merNo": "104001001",
    "sceneName": "Monthly Subscription",
    "sceneId": "VPA_SCENE_001",
    "startTime": "2026-05-22 00:00:00",
    "endTime": "2026-12-31 23:59:59",
    "maxNum": "30",
    "maxAmount": 5000,
    "type": "SUBSCRIPTION",
    "cycleType": 1,
    "cycleDay": "1",
    "sign": "A1B2C3D4E5F6...",
    "signType": "RSA256",
    "version": "V2.0.0"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://testpay.onlinepay.ai/v2/card/addVpaScene' \
--header 'paymentType: CARD' \
--header 'Referer: https://example.com' \
--header 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...' \
--header 'lang: en-US' \
--header 'orderType;' \
--header 'Content-Type: application/json' \
--data '{
    "merNo": "104001001",
    "sceneName": "Monthly Subscription",
    "sceneId": "VPA_SCENE_001",
    "startTime": "2026-05-22 00:00:00",
    "endTime": "2026-12-31 23:59:59",
    "maxNum": "30",
    "maxAmount": 5000,
    "type": "SUBSCRIPTION",
    "cycleType": 1,
    "cycleDay": "1",
    "sign": "A1B2C3D4E5F6...",
    "signType": "RSA256",
    "version": "V2.0.0"
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "code": "00000",
    "message": "SUCCESS",
    "data": ""
}

Modified at 2026-05-26 02:54:05

Query Card Transaction API

UploadFile API