PayNow

Discord

Get Actions

GEThttps://api.paynow.gg/v1/stores/{storeId}/product_versions/{productVersionId}/discord_actions
Headers
AuthorizationAPI KeyRequired
Authentication token for this request, sent as Authorization: APIKey TOKEN.
Path parameters
storeIdFlakeIdRequired
productVersionIdFlakeIdRequired
Response
200OKDiscordActionDto[]
Show fields
action_typeenumRequired
Possible enum values
  • persist_role
  • send_message
  • ban_user
  • kick_user
  • generate_invite_link
discord_server_idFlakeIdRequired
execution_stageenumRequired
Possible enum values
  • on_purchase
  • on_expire
  • on_refund
  • on_chargeback
idFlakeIdRequired
product_idFlakeIdRequired
product_version_idFlakeIdRequired
revocation_stagesenum[]Required
Possible enum values
  • on_expire
  • on_refund
  • on_chargeback
store_idFlakeIdRequired
channel_idFlakeIdOptional
messagestringOptional
role_idFlakeIdOptional

Failed requests return a PayNowError body. See the error response guide.

curl -X GET "https://api.paynow.gg/v1/stores/{storeId}/product_versions/{productVersionId}/discord_actions" \
  -H "Authorization: APIKey TOKEN"
Response200
[
  {
    "action_type": "persist_role",
    "discord_server_id": "411486491630370816",
    "execution_stage": "on_purchase",
    "id": "411486491630370816",
    "product_id": "411486491630370816",
    "product_version_id": "411486491630370816",
    "revocation_stages": [
      "on_expire"
    ],
    "store_id": "411486491630370816",
    "channel_id": "411486491630370816",
    "role_id": "411486491630370816",
    "message": "string"
  }
]

Create Action

PUThttps://api.paynow.gg/v1/stores/{storeId}/product_versions/{productVersionId}/discord_actions
Headers
AuthorizationAPI KeyRequired
Authentication token for this request, sent as Authorization: APIKey TOKEN.
Path parameters
storeIdFlakeIdRequired
productVersionIdFlakeIdRequired
Request body
action_typeenumRequired
Possible enum values
  • persist_role
  • send_message
  • ban_user
  • kick_user
  • generate_invite_link
discord_server_idFlakeIdRequired
execution_stageenumRequired
Possible enum values
  • on_purchase
  • on_expire
  • on_refund
  • on_chargeback
channel_idFlakeIdOptional
messagestringOptional
revocation_stagesenum[]Optional
Possible enum values
  • on_expire
  • on_refund
  • on_chargeback
role_idFlakeIdOptional
Response
200OKDiscordActionDto
Show fields
action_typeenumRequired
Possible enum values
  • persist_role
  • send_message
  • ban_user
  • kick_user
  • generate_invite_link
discord_server_idFlakeIdRequired
execution_stageenumRequired
Possible enum values
  • on_purchase
  • on_expire
  • on_refund
  • on_chargeback
idFlakeIdRequired
product_idFlakeIdRequired
product_version_idFlakeIdRequired
revocation_stagesenum[]Required
Possible enum values
  • on_expire
  • on_refund
  • on_chargeback
store_idFlakeIdRequired
channel_idFlakeIdOptional
messagestringOptional
role_idFlakeIdOptional

Failed requests return a PayNowError body. See the error response guide.

curl -X PUT "https://api.paynow.gg/v1/stores/{storeId}/product_versions/{productVersionId}/discord_actions" \
  -H "Authorization: APIKey TOKEN" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "action_type": "persist_role",
    "discord_server_id": "411486491630370816",
    "execution_stage": "on_purchase",
    "revocation_stages": [
      "on_expire"
    ],
    "channel_id": "411486491630370816",
    "role_id": "411486491630370816",
    "message": "string"
  }
]'
Response200
{
  "action_type": "persist_role",
  "discord_server_id": "411486491630370816",
  "execution_stage": "on_purchase",
  "id": "411486491630370816",
  "product_id": "411486491630370816",
  "product_version_id": "411486491630370816",
  "revocation_stages": [
    "on_expire"
  ],
  "store_id": "411486491630370816",
  "channel_id": "411486491630370816",
  "role_id": "411486491630370816",
  "message": "string"
}

Get Linked Discord Accounts

GEThttps://api.paynow.gg/v1/stores/{storeId}/orders/{orderId}/discord
Headers
AuthorizationAPI KeyRequired
Authentication token for this request, sent as Authorization: APIKey TOKEN.
Path parameters
storeIdFlakeIdRequired
orderIdFlakeIdRequired
Response
200OKobject

Failed requests return a PayNowError body. See the error response guide.

curl -X GET "https://api.paynow.gg/v1/stores/{storeId}/orders/{orderId}/discord" \
  -H "Authorization: APIKey TOKEN"
Response200
{}

Get Discord Action Execution History

GEThttps://api.paynow.gg/v1/stores/{storeId}/orders/{orderId}/discord/queued
Headers
AuthorizationAPI KeyRequired
Authentication token for this request, sent as Authorization: APIKey TOKEN.
Path parameters
storeIdFlakeIdRequired
orderIdFlakeIdRequired
Response
200OKQueuedDiscordActionDto[]
Show fields
action_typeenumRequired
Possible enum values
  • persist_role
  • send_message
  • ban_user
  • kick_user
  • generate_invite_link
delivery_item_idFlakeIdRequired
discord_server_idFlakeIdRequired
enqueued_atstringRequired
execution_stageenumRequired
Possible enum values
  • on_purchase
  • on_expire
  • on_refund
  • on_chargeback
executionsQueuedDiscordActionExecutionDto[]Required
executed_atstringRequired
execution_statusenumRequired
Possible enum values
  • success
  • failure
idintegerRequired
queue_idintegerRequired
messagestringOptional
trace_idstringOptional
idintegerRequired
product_idFlakeIdRequired
product_version_idFlakeIdRequired
revocation_stagesenum[]Required
Possible enum values
  • on_expire
  • on_refund
  • on_chargeback
statusenumRequired
Possible enum values
  • active
  • complete
  • errored
  • canceled
store_idFlakeIdRequired
channel_idFlakeIdOptional
checkout_idFlakeIdOptional
checkout_line_idFlakeIdOptional
discord_user_idFlakeIdOptional
finalised_atstringOptional
messagestringOptional
order_idFlakeIdOptional
role_idFlakeIdOptional

Failed requests return a PayNowError body. See the error response guide.

curl -X GET "https://api.paynow.gg/v1/stores/{storeId}/orders/{orderId}/discord/queued" \
  -H "Authorization: APIKey TOKEN"
Response200
[
  {
    "action_type": "persist_role",
    "delivery_item_id": "411486491630370816",
    "discord_server_id": "411486491630370816",
    "enqueued_at": "2024-01-01T00:00:00Z",
    "execution_stage": "on_purchase",
    "executions": [
      {
        "executed_at": "2024-01-01T00:00:00Z",
        "execution_status": "success",
        "id": 0,
        "queue_id": 0,
        "message": "string",
        "trace_id": "string"
      }
    ],
    "id": 0,
    "product_id": "411486491630370816",
    "product_version_id": "411486491630370816",
    "revocation_stages": [
      "on_expire"
    ],
    "status": "active",
    "store_id": "411486491630370816",
    "order_id": "411486491630370816",
    "checkout_id": "411486491630370816",
    "checkout_line_id": "411486491630370816",
    "discord_user_id": "411486491630370816",
    "channel_id": "411486491630370816",
    "role_id": "411486491630370816",
    "message": "string",
    "finalised_at": "2024-01-01T00:00:00Z"
  }
]

Get Queued Discord Action For Delivery Item

GEThttps://api.paynow.gg/v1/stores/{storeId}/inventory/{inventoryItemId}/discord/queued
Headers
AuthorizationAPI KeyRequired
Authentication token for this request, sent as Authorization: APIKey TOKEN.
Path parameters
storeIdFlakeIdRequired
inventoryItemIdFlakeIdRequired
Response
200OKQueuedDiscordActionDto[]
Show fields
action_typeenumRequired
Possible enum values
  • persist_role
  • send_message
  • ban_user
  • kick_user
  • generate_invite_link
delivery_item_idFlakeIdRequired
discord_server_idFlakeIdRequired
enqueued_atstringRequired
execution_stageenumRequired
Possible enum values
  • on_purchase
  • on_expire
  • on_refund
  • on_chargeback
executionsQueuedDiscordActionExecutionDto[]Required
executed_atstringRequired
execution_statusenumRequired
Possible enum values
  • success
  • failure
idintegerRequired
queue_idintegerRequired
messagestringOptional
trace_idstringOptional
idintegerRequired
product_idFlakeIdRequired
product_version_idFlakeIdRequired
revocation_stagesenum[]Required
Possible enum values
  • on_expire
  • on_refund
  • on_chargeback
statusenumRequired
Possible enum values
  • active
  • complete
  • errored
  • canceled
store_idFlakeIdRequired
channel_idFlakeIdOptional
checkout_idFlakeIdOptional
checkout_line_idFlakeIdOptional
discord_user_idFlakeIdOptional
finalised_atstringOptional
messagestringOptional
order_idFlakeIdOptional
role_idFlakeIdOptional

Failed requests return a PayNowError body. See the error response guide.

curl -X GET "https://api.paynow.gg/v1/stores/{storeId}/inventory/{inventoryItemId}/discord/queued" \
  -H "Authorization: APIKey TOKEN"
Response200
[
  {
    "action_type": "persist_role",
    "delivery_item_id": "411486491630370816",
    "discord_server_id": "411486491630370816",
    "enqueued_at": "2024-01-01T00:00:00Z",
    "execution_stage": "on_purchase",
    "executions": [
      {
        "executed_at": "2024-01-01T00:00:00Z",
        "execution_status": "success",
        "id": 0,
        "queue_id": 0,
        "message": "string",
        "trace_id": "string"
      }
    ],
    "id": 0,
    "product_id": "411486491630370816",
    "product_version_id": "411486491630370816",
    "revocation_stages": [
      "on_expire"
    ],
    "status": "active",
    "store_id": "411486491630370816",
    "order_id": "411486491630370816",
    "checkout_id": "411486491630370816",
    "checkout_line_id": "411486491630370816",
    "discord_user_id": "411486491630370816",
    "channel_id": "411486491630370816",
    "role_id": "411486491630370816",
    "message": "string",
    "finalised_at": "2024-01-01T00:00:00Z"
  }
]

Get Discord Server Roles

GEThttps://api.paynow.gg/v1/stores/{storeId}/discord/{discordServerId}/roles
Headers
AuthorizationAPI KeyRequired
Authentication token for this request, sent as Authorization: APIKey TOKEN.
Path parameters
storeIdFlakeIdRequired
discordServerIdintegerRequired
Response
200OKDiscordServerRoleDto[]
Show fields
idFlakeIdRequired
namestringRequired

Failed requests return a PayNowError body. See the error response guide.

curl -X GET "https://api.paynow.gg/v1/stores/{storeId}/discord/{discordServerId}/roles" \
  -H "Authorization: APIKey TOKEN"
Response200
[
  {
    "id": "411486491630370816",
    "name": "string"
  }
]

Get Discord Server Text Channels

GEThttps://api.paynow.gg/v1/stores/{storeId}/discord/{discordServerId}/discord/text_channels
Headers
AuthorizationAPI KeyRequired
Authentication token for this request, sent as Authorization: APIKey TOKEN.
Path parameters
storeIdFlakeIdRequired
discordServerIdintegerRequired
Response
200OKDiscordServerChannelDto[]
Show fields
categorystringRequired
idstringRequired
namestringRequired

Failed requests return a PayNowError body. See the error response guide.

curl -X GET "https://api.paynow.gg/v1/stores/{storeId}/discord/{discordServerId}/discord/text_channels" \
  -H "Authorization: APIKey TOKEN"
Response200
[
  {
    "category": "string",
    "id": "string",
    "name": "string"
  }
]