E2ECreate Coupons
POST
/couponsSummer Clearance 25% — once (THB)
25% off, summer.
Request
Example
curl -X POST 'https://api.paycose.com/api/v1/app1/platform/wallet/coupons/' \
-H 'X-Session-Token: {{session_token}}' \
-H 'X-Country: {{country}}' \
-H 'X-Test-Mode: {{x_test_mode}}' \
-d '{
"name": "Summer Clearance 25%",
"active": true,
"duration": "once",
"duration_in_months": null,
"percentage": 25,
"fixed_amount": null,
"currency": "THB",
"redeem_by": "2026-08-31T23:59:59Z",
"metadata": {
"campaign": "summer_clearance"
},
"labels": [
"<string>"
]
}'Headers
| Name | Value | Description |
|---|---|---|
| X-Session-Token | {{session_token}} | |
| X-Country | {{country}} | |
| X-Test-Mode | {{x_test_mode}} | true=wallet_test, false=wallet_live (default). Toggle the x_test_mode collection variable to flip every applicable request. |
Body
| Name | Type | Value |
|---|---|---|
| name | string | Summer Clearance 25% |
| active | boolean | true |
| duration | string | once |
| duration_in_months | null | null |
| percentage | number | 25 |
| fixed_amount | null | null |
| currency | string | THB |
| redeem_by | string | 2026-08-31T23:59:59Z |
| metadata | object | {…} |
| labels | array | [1] |
{
"name": "Summer Clearance 25%",
"active": true,
"duration": "once",
"duration_in_months": null,
"percentage": 25,
"fixed_amount": null,
"currency": "THB",
"redeem_by": "2026-08-31T23:59:59Z",
"metadata": {
"campaign": "summer_clearance"
},
"labels": [
"<string>"
]
}Responses
200200 OK
Headers
| Name | Value |
|---|---|
| Content-Type | application/json |
Body
{
"id": "<string>",
"object": "<string>",
"resource": "<string>",
"created_at": "<RFC3339 timestamp>",
"errors": [
{
"code": "<string>",
"message": "<string>"
}
],
"next_action": [
{
"type": "<string>",
"title": "<string>",
"description": "<string>",
"i18n_key": "<string>",
"url": "<string>",
"client_secret": "<string>",
"payment_method": "<string>",
"qr_data": "<string>"
}
]
}500500 Internal Server Error
Headers
| Name | Value |
|---|---|
| Content-Type | application/json |
Body
{
"object": "error",
"code": "<string>",
"key": "<string>",
"i18n_key": "<string>",
"message": "<string>",
"request_id": "<string>"
}