WooshPay OpenAPI
Product DocumentAPI ReferenceJS SDK ReferenceSaaS Platform Integration
Product DocumentAPI ReferenceJS SDK ReferenceSaaS Platform Integration
Back to WooshPay Website
  1. Cards
  • API introduction
  • Error Code
  • Checkout
    • Create a Session
      POST
    • Expire a Session
      POST
    • Retreive a Session
      GET
    • List All Checkout Sessions
      GET
    • Retrieve a Checkout Session's line items
      GET
    • Expire a Session Copy
      POST
  • Payment Intents
    • Create a PaymentIntent
      POST
    • Update a PaymentIntent
      POST
    • Cancel a PaymentIntent
      POST
    • Capture a PaymentIntent
      POST
    • Confirm a PaymentIntent
      POST
    • Retrieve a PaymentIntent
      GET
    • List all PaymentIntents
      GET
    • Search PaymentIntents
      GET
  • Setup Intents
    • Create a SetupIntent
      POST
    • Retrieve a SetupIntent
      GET
    • Cancel a SetupIntent
      POST
    • List all SetupIntents
      GET
    • List all SetupAttempts
      GET
    • Update a SetupIntent
      POST
    • Confirm a SetupIntent
      POST
  • Refunds
    • Create a refund
    • Retrieve a refund
  • Payouts
    • Payouts
      • Create a payout
      • Retrieve a Payout
      • Update a Payout
      • List All Payouts
    • Beneficiary
      • Create a beneficiary
      • Retrieve a beneficiary
      • List all beneficiaries
      • Update a beneficiary
      • Delete a beneficiary
  • Charges
    • Retrieve a charge
    • List all charges
  • Webhooks
    • Create a Webhook
    • List All Webhooks
    • Retrieve a Webhook
    • Delete a Webhook
    • Update a Webhook
  • Events
    • Types of events
    • Retrieve an event
  • Payment Methods
    • Create a PaymentMethod
    • Retrieve a PaymentMethod
    • Retrieve a Customer's PaymentMethod
    • Update a PaymentMethod
    • List PaymentMethods
    • List a Customer's PaymentMethods
    • Attach a PaymentMethod to a Customer
    • Detach a PaymentMethod from a Customer
  • Files
    • Files
    • Create a file
    • Retrieve a file
  • Disputes
    • Retrieve a dispute
    • Update a dispute
    • Close a dispute
    • List all disputes
  • Balance
    • Get balance
  • Products
    • Create a Product
    • Retrieve a product
    • Update a product
    • List all products
  • Prices
    • Create a price
    • Retrieve a price
    • Update a price
  • Payment Links
    • Create a payment link
    • Update a payment link
    • Retrieve payment link
    • List all payment links
    • Retrieve a payment link's line items
  • Customers
    • Create a customer
    • Retrieve a customer
    • Update a customer
  • Invoices
    • Create an invoice
    • Retrieve an invoice
    • Finalize an invoice
    • Send an invoice for manual payment
    • Delete a draft invoice
    • Void an invoice
    • List all invoices
    • Pay an invoice
  • Invoice Items
    • Create an invoice item
    • Retrieve an invoice item
  • Invoice Line Item
    • Bulk add invoice line items
  • Subscriptions
    • Create a subscription
    • Retrieve a subscription
    • Update a subscription
    • Cancel a subscription
    • List subscriptions
  • Subscription Items
    • Create a subscription item
    • Retrieve a subscription item
    • Delete a subscription item
  • Issuing
    • Authorizations
      • Retrieve an authorization
      • List all authorization
    • Cardholders
      • Create a cardholder
      • Update a cardholder
      • Retrieve a cardholder
      • List all cardholders
    • Cards
      • Create a card
        POST
      • Update a card
        POST
      • Retrieve a card
        GET
      • List all cards
        GET
      • Retrieve card remaining limits
        GET
    • Transactions
      • Update a transaction
      • Retrieve a transaction
      • List all transactions
  • Coupons
    • Create a Coupon
    • Retrieve a coupon
    • Delete a coupon
  • Promotion Code
    • Create a promotion code
    • Update a promotion code
  • Accounts
    • Retrieve account's paymentmethods
  • FX Quote
    • Create an FX Quote
  1. Cards

Create a card

POST
/v1/issuing/cards

Request

Authorization
Send your HTTP requests with an
Authorization
header that contains the word Basic followed by a space and a base64-encoded string username:password
Example:
Authorization: Basic *****************
Header Params

Body Params application/json

Example
{
    "currency": "string",
    "type": "virtual",
    "cardholder": "string",
    "metadata": "string",
    "status": "active",
    "spending_controls": {
        "spending_limits": [
            {
                "amount": "string",
                "interval": "all_time"
            }
        ],
        "spending_limits_currency": "string"
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://apitest.wooshpay.com/v1/issuing/cards' \
--header 'Accept;' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "currency": "string",
    "type": "virtual",
    "cardholder": "string",
    "metadata": "string",
    "status": "active",
    "spending_controls": {
        "spending_limits": [
            {
                "amount": "string",
                "interval": "all_time"
            }
        ],
        "spending_limits_currency": "string"
    }
}'

Responses

🟢200OK
application/json
Body

Example
{
    "id": "string",
    "cancellation_reason": "lost",
    "currency": "string",
    "type": "virtual",
    "cardholder": {
        "id": "string",
        "object": "string",
        "billing": {
            "address": {
                "city": "string",
                "country": "string",
                "line1": "string",
                "line2": "string",
                "postal_code": "string",
                "state": "string"
            }
        },
        "name": "string",
        "email": "string",
        "phone_number": "string",
        "metadata": [
            {}
        ],
        "company": {
            "tax_id_provided": true
        },
        "created": 0,
        "individual": {
            "card_issuing": {
                "user_terms_acceptance": {
                    "date": 0,
                    "ip": "string",
                    "user_agent": "string"
                }
            },
            "dob": {
                "day": 0,
                "month": 0,
                "year": 0
            },
            "first_name": "string",
            "last_name": "string",
            "verification": {
                "document": {
                    "back": "string",
                    "front": "string"
                }
            }
        },
        "livemode": true,
        "spending_controls": {
            "spending_limits": {
                "amount": 0,
                "interval": "per_authorization"
            },
            "spending_limits_currency": "string"
        },
        "status": "active",
        "type": "individual"
    },
    "exp_month": 0,
    "exp_year": 0,
    "first6": "string",
    "last4": "string",
    "metadata": "string",
    "status": "active",
    "object": "string",
    "brand": "string",
    "created": "string",
    "cvc": "string",
    "livemode": true,
    "number": "string",
    "spending_controls": {
        "spending_limits": [
            {
                "amount": "string",
                "interval": "all_time"
            }
        ],
        "spending_limits_currency": "string"
    }
}
Modified at 2025-01-08 12:51:32
Previous
List all cardholders
Next
Update a card
Built with