> ## Documentation Index > Fetch the complete documentation index at: https://docs.paywint.com/llms.txt > Use this file to discover all available pages before exploring further. # Issue Paywint Card For Payee > Issues and funds a Paywint Card for a payee. This endpoint performs the following operations: - Verifies that the payee exists. - Confirms the payee has a default address set. - Validates that the issuing account's Paywint wallet has sufficient available balance. - Deducts the initial load amount from the issuing account's wallet. - Creates the paywint card request associated with the payee. Prerequisites: - The payee must be created using the Create Payee endpoint. - A default address must be set using either the Create Payee Address or Set Default Payee Address endpoint. - The default address is used as the billing address for the issued paywint card. Requirements: - `amount` is required. - Minimum initial load amount is $2.00. - `card_nickname` is optional. - If `card_nickname` is not provided, the default value "My Paywint Card" will be used. The initial load amount is immediately deducted from the issuing account’s available wallet balance at the time of the request. Returns the created paywint card request. ## OpenAPI ````yaml POST /api/user-api/card/payee/pw-card/request openapi: 3.1.0 info: title: paywint version: 0.1.0 servers: - url: https://api.sandbox.paywint.com - url: https://api.paywint.com security: [] paths: /api/user-api/card/payee/pw-card/request: post: tags: - Developer API card summary: Issue a funded Paywint Card for a payee description: >- Issues and funds a Paywint Card for a payee. This endpoint performs the following operations: - Verifies that the payee exists. - Confirms the payee has a default address set. - Validates that the issuing account's Paywint wallet has sufficient available balance. - Deducts the initial load amount from the issuing account's wallet. - Creates the paywint card request associated with the payee. Prerequisites: - The payee must be created using the Create Payee endpoint. - A default address must be set using either the Create Payee Address or Set Default Payee Address endpoint. - The default address is used as the billing address for the issued paywint card. Requirements: - `amount` is required. - Minimum initial load amount is $2.00. - `card_nickname` is optional. - If `card_nickname` is not provided, the default value "My Paywint Card" will be used. The initial load amount is immediately deducted from the issuing account’s available wallet balance at the time of the request. Returns the created paywint card request. operationId: >- request_paywint_card_for_contact_api_user_api_card_payee_pw_card_request_post parameters: - name: X-Api-Key in: header required: true schema: type: string description: >- Your API Key (UUID format). Required to identify and authorize each request title: X-Api-Key description: >- Your API Key (UUID format). Required to identify and authorize each request - name: X-Api-Secret in: header required: true schema: type: string description: >- Secret associated with your API Key. Used for authenticating requests. Keep this secure. title: X-Api-Secret description: >- Secret associated with your API Key. Used for authenticating requests. Keep this secure. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ExternalPaywintgiftCardRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: >- #/components/schemas/CommonResponse_ExternalPaywintGiftCardRequestRead_ '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: ExternalPaywintgiftCardRequest: properties: payee_id: type: string format: uuid title: Payee Id description: >- The unique identifier of the existing payee who will receive the Paywint Card. The payee must already be created and must have a default address set. example: c9b1f3b2-8d9a-4f1b-a9e5-6a77f0b12345 card_nick_name: type: string maxLength: 30 minLength: 1 title: Card Nick Name description: >- Optional nickname for the card. If not provided, the default value "My Paywint Card" will be used. Must be between 1 and 30 characters. default: My Paywint Card example: Holiday Bonus Card amount: type: number minimum: 2 title: Amount description: >- The amount to preload onto the card in USD. Minimum allowed value is $2.00. This amount is immediately deducted from the issuing account's available Paywint wallet balance. example: 50 type: object required: - payee_id - amount title: ExternalPaywintgiftCardRequest example: amount: 50 card_nick_name: Holiday Bonus Card payee_id: c9b1f3b2-8d9a-4f1b-a9e5-6a77f0b12345 CommonResponse_ExternalPaywintGiftCardRequestRead_: properties: success: type: boolean title: Success description: Indicates whether the request was processed successfully. default: true example: true message: type: string title: Message description: >- A short, human-readable message describing the result of the request. default: Success example: Operation completed. data: anyOf: - $ref: '#/components/schemas/ExternalPaywintGiftCardRequestRead' - type: 'null' description: The main response payload, if applicable queryGeneratedTime: anyOf: - type: number - type: 'null' title: Querygeneratedtime description: >- The Unix timestamp (in seconds) indicating when the response was generated. default: 1778161546.973489 example: 1718006400 type: object title: CommonResponse[ExternalPaywintGiftCardRequestRead] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ExternalPaywintGiftCardRequestRead: properties: payee_id: type: string format: uuid title: Payee Id description: >- The unique identifier of the payee associated with this Paywint Card request. example: c9b1f3b2-8d9a-4f1b-a9e5-6a77f0b12345 request_id: type: string format: uuid title: Request Id description: Unique identifier for the Paywint Card request. example: f24a8e7c-7f2b-4f39-bc5d-98e01a123456 reference_id: anyOf: - type: integer - type: 'null' title: Reference Id description: >- Reference identifier for this Paywint Card request. Keep this value safe for reconciliation and support. example: 10472 payment_id: anyOf: - type: string format: uuid - type: 'null' title: Payment Id description: Unique payment identifier created for this Paywint Card request. example: a42d67b4-0d65-4b89-b91e-0fcba5f65d9a card_nick_name: type: string title: Card Nick Name description: Nickname assigned to the Paywint Card. example: Employee Performance Bonus status: $ref: '#/components/schemas/CardApprovalStatus' description: >- Current lifecycle status of the card request. Typical values include `initiated`, `pending`, `approved`, or `rejected`. default: pending example: pending amount: type: number title: Amount description: >- The funded amount loaded onto the Paywint Card in USD. This amount was deducted from the issuing account's wallet at the time of request. example: 150 first_name: type: string title: First Name description: First name printed on the Paywint Card. example: Michael last_name: type: string title: Last Name description: Last name printed on the Paywint Card. example: Anderson address_line: type: string title: Address Line description: Billing address line from the payee’s default address. example: 742 Evergreen Terrace city: type: string title: City description: Billing city of the payee. example: Austin state: type: string title: State description: Billing state or region of the payee. example: TX zip: type: string title: Zip description: Billing ZIP or postal code of the payee. example: '78701' country: type: string title: Country description: Billing country (ISO 3166-1 alpha-2 format). example: US created_at: type: string format: date-time title: Created At description: Timestamp in ISO 8601 UTC format when the card request was created. example: '2026-02-12T10:15:30Z' type: object title: ExternalPaywintGiftCardRequestRead example: address_line: 742 Evergreen Terrace amount: 150 card_nick_name: Employee Performance Bonus city: Austin country: US created_at: '2026-02-12T10:15:30Z' first_name: Michael last_name: Anderson payee_id: c9b1f3b2-8d9a-4f1b-a9e5-6a77f0b12345 payment_id: a42d67b4-0d65-4b89-b91e-0fcba5f65d9a reference_id: 10472 request_id: f24a8e7c-7f2b-4f39-bc5d-98e01a123456 state: TX status: pending zip: '78701' ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError CardApprovalStatus: type: string enum: - initiated - payment_processing - payment_failed - pending - approved - activating - auto_approved - rejected title: CardApprovalStatus ````