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:
amountis required.- Minimum initial load amount is $2.00.
card_nicknameis optional.- If
card_nicknameis 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.
Headers
Your API Key (UUID format). Required to identify and authorize each request
Secret associated with your API Key. Used for authenticating requests. Keep this secure.
Body
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.
"c9b1f3b2-8d9a-4f1b-a9e5-6a77f0b12345"
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.
x >= 250
Optional nickname for the card. If not provided, the default value "My Paywint Card" will be used. Must be between 1 and 30 characters.
1 - 30"Holiday Bonus Card"
Response
Successful Response
Indicates whether the request was processed successfully.
true
A short, human-readable message describing the result of the request.
"Operation completed."
The main response payload, if applicable
{
"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"
}
The Unix timestamp (in seconds) indicating when the response was generated.
1718006400