Create Payment
Registers a payment record.
Auto attribution:
- If
campaignIdis not specified, automatically attributed to the project’s active campaign
Currency conversion:
- If
currencyis not USD, USD amount will be automatically calculated (amountUsd)
Authorizations
Server API Key (format: {keyId}:{secret})
Body
User ID
Unique transaction ID (provided by platform)
Product ID
Payment amount
x >= 0.01Currency code (ISO 4217, required)
- USD, KRW recommended
- e.g., USD, KRW, JPY, EUR
^[A-Z]{3}$Payment platform
iOS, Android, Web, Roblox, Other Product name (optional)
Distribution type (optional, determines store fee):
MOBILE_STORE: Mobile external store (Google Play, App Store) - 30%PC_STORE: PC external store (Steam, etc.) - 30%MOBILE_SELF_STORE: Mobile self-payment - 0%PC_SELF_STORE: PC self-store - 0%
When omitted, it is inferred from platform:
iOS/Android → MOBILE_STORE, Web → PC_SELF_STORE, Roblox/Other → PC_STORE.
Send it explicitly whenever the inferred value would be wrong for your build.
MOBILE_STORE, MOBILE_SELF_STORE, PC_STORE, PC_SELF_STORE Payment time (ISO 8601 UTC format, optional)
- Format:
YYYY-MM-DDTHH:mm:ss.sssZ - Example:
2024-01-15T10:30:00.000Z - When omitted, the server records the time it received the request
Settlement is always attributed to the moment the SDK API recorded the payment, so call the API as soon as the payment completes.
Net amount after store fees (optional)
x >= 0.01Currency of netAmount (ISO 4217, optional)
^[A-Z]{3}$Webhook tracking ID (included in webhook events triggered by this request)
Test mode (does not create actual data)
Response
Success