> ## Documentation Index > Fetch the complete documentation index at: https://playcamp.io/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create Bulk Payment > Registers up to 1,000 payment records at once. **Partial success:** Each item is processed independently with SUCCESS/SKIPPED/FAILED status. Existing transactionIds are SKIPPED (not duplicated). ## OpenAPI ````yaml /api_docs/openapi.yaml post /v1/server/payments/bulk openapi: 3.0.3 info: title: PlayCamp SDK API description: > PlayCamp SDK API - Game analytics and creator campaign integration API ## Required Integration APIs (Server API) 3 APIs that must be integrated for campaign operation: - `POST /v1/server/sponsors` - User boosts a creator - `POST /v1/server/coupons/validate` - Validate coupon code - `POST /v1/server/payments` - Register in-game payment ## Authentication - **Client API**: `Authorization: Bearer {CLIENT_KEY_ID}:{CLIENT_SECRET}` - **Server API**: `Authorization: Bearer {SERVER_KEY_ID}:{SERVER_SECRET}` ## Servers - **Live**: https://sdk-api.playcamp.io (Production data) - **Sandbox**: https://sandbox-sdk-api.playcamp.io (Test data) ## Key Types - **Client Key**: For game client (read-only - campaign, creator queries) - **Server Key**: For game server (read/write - coupon redemption, payment registration, etc.) ## Test Mode (isTest) Before campaign launch, use `isTest: true` parameter to test API integration. - Request parameter validation is performed identically to production - Returns mock data without recording to actual DB - Verify integration in Sandbox environment before campaign launch, then remove `isTest` parameter for actual campaign version: 1.1.0 contact: name: PlayCamp Support servers: - url: https://sdk-api.playcamp.io description: Live Server - url: https://sandbox-sdk-api.playcamp.io description: Sandbox Server - url: http://localhost:3001 description: Local Live Server - url: http://localhost:3003 description: Local Sandbox Server security: [] tags: - name: Health description: Server health check - name: Client Campaign description: Campaign queries (Client API) - name: Client Creator description: Creator queries (Client API) - name: Client Coupon description: Coupon validation (Client API) - name: Client Sponsor description: Boost status queries — Sponsor API (Client API) - name: Server Campaign description: Campaign queries (Server API) - name: Server Creator description: Creator queries (Server API) - name: Server Coupon description: Coupon management (Server API) - name: Server Sponsor description: Boost management — Sponsor API (Server API) - name: Server Payment description: Payment management (Server API) - name: Server Playtime description: Playtime session management (Server API) - name: Server Webhook description: Webhook management (Server API) - name: Server Webview description: WebView management (Server API) paths: /v1/server/payments/bulk: post: tags: - Server Payment summary: Create Bulk Payment description: > Registers up to 1,000 payment records at once. **Partial success:** Each item is processed independently with SUCCESS/SKIPPED/FAILED status. Existing transactionIds are SKIPPED (not duplicated). operationId: serverCreateBulkPayment requestBody: required: true content: application/json: schema: type: object required: - payments properties: payments: type: array maxItems: 1000 items: type: object required: - userId - transactionId - productId - amount - currency - platform - distributionType - purchasedAt properties: userId: type: string transactionId: type: string productId: type: string productName: type: string amount: type: number minimum: 0.01 currency: type: string pattern: ^[A-Z]{3}$ platform: type: string enum: - iOS - Android - Web - Roblox - Other distributionType: type: string enum: - MOBILE_STORE - MOBILE_SELF_STORE - PC_STORE - PC_SELF_STORE purchasedAt: type: string format: date-time callbackId: type: string description: Webhook tracking ID isTest: type: boolean default: false description: Test mode (does not create actual data) responses: '200': description: Success content: application/json: schema: type: object required: - data properties: data: $ref: '#/components/schemas/BulkPaymentResult' '400': $ref: '#/components/responses/ValidationError' '401': $ref: '#/components/responses/Unauthorized' security: - ServerAuth: [] components: schemas: BulkPaymentResult: type: object description: Bulk payment result properties: totalRequested: type: integer description: Total number of payment items requested successful: type: integer description: Number of successfully registered payments failed: type: integer description: Number of failed payments skipped: type: integer description: Number of skipped payments (duplicate transactionId) results: type: array items: type: object properties: transactionId: type: string status: type: string enum: - SUCCESS - SKIPPED - FAILED data: $ref: '#/components/schemas/Payment' error: type: string description: Error message (only for FAILED status) Payment: type: object properties: id: type: integer transactionId: type: string userId: type: string productId: type: string productName: type: string amount: type: number currency: type: string amountUsd: type: number description: USD converted amount (auto-calculated) platform: type: string enum: - iOS - Android - Web - Roblox - Other distributionType: type: string enum: - MOBILE_STORE - MOBILE_SELF_STORE - PC_STORE - PC_SELF_STORE description: > Distribution type (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-published store - 0% status: type: string enum: - COMPLETED - REFUNDED campaignId: type: string creatorKey: type: string purchasedAt: type: string format: date-time createdAt: type: string format: date-time ValidationError: type: object required: - status - error - message - code - details properties: status: type: integer example: 400 error: type: string example: Bad Request message: type: string example: Validation failed code: type: string example: VALIDATION_ERROR details: type: array items: type: object properties: path: type: string description: Field path where error occurred message: type: string description: Error message example: - path: userId message: Required - path: amount message: Expected number, received string Error: type: object required: - status - error - message - code properties: status: type: integer description: HTTP status code error: type: string description: HTTP status name message: type: string description: Detailed error message code: type: string description: | Error codes: - `VALIDATION_ERROR`: Request parameter validation failed - `BAD_REQUEST`: Invalid request - `UNAUTHORIZED`: Authentication failed (API key error) - `FORBIDDEN`: Access denied - `NOT_FOUND`: Resource not found - `CONFLICT`: Duplicate resource (already exists) - `INTERNAL_ERROR`: Internal server error details: type: array description: Validation error details (for VALIDATION_ERROR) items: type: object properties: path: type: string message: type: string example: status: 404 error: Not Found message: 'Payment not found: txn-12345' code: NOT_FOUND responses: ValidationError: description: Request parameter validation failed content: application/json: schema: $ref: '#/components/schemas/ValidationError' Unauthorized: description: Authentication failed (API key error) content: application/json: schema: $ref: '#/components/schemas/Error' example: status: 401 error: Unauthorized message: Invalid API key code: UNAUTHORIZED securitySchemes: ServerAuth: type: http scheme: bearer description: 'Server API Key (format: {keyId}:{secret})' ````