WooshPay OpenAPI
Product DocumentAPI ReferenceJS SDK ReferenceSaaS Platform Integration
Product DocumentAPI ReferenceJS SDK ReferenceSaaS Platform Integration
Back to WooshPay Website
  1. Payment Methods
  • API Introduction
  • Error Code
  • 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
  • Charges
    • Retrieve a charge
      GET
    • List all charges
      GET
  • Payment Methods
    • Create a PaymentMethod
      POST
    • Retrieve a PaymentMethod
      GET
    • Retrieve a Customer's PaymentMethod
      GET
    • Update a PaymentMethod
      POST
    • List PaymentMethods
      GET
    • List a Customer's PaymentMethods
      GET
    • Attach a PaymentMethod to a Customer
      POST
    • Detach a PaymentMethod from a Customer
      POST
  • Refunds
    • Create a refund
      POST
    • Retrieve a refund
      GET
  • Webhooks
    • Create a Webhook
      POST
    • List All Webhooks
      GET
    • Retrieve a Webhook
      GET
    • Delete a Webhook
      DELETE
    • Update a Webhook
      POST
  • Events
    • Types of events
    • Retrieve an event
      GET
  • Files
    • Files
    • Create a file
      POST
    • Retrieve a file
      GET
  • Disputes
    • Retrieve a dispute
      GET
    • Update a dispute
      POST
    • Close a dispute
      POST
    • List all disputes
      GET
  • Payouts
    • Beneficiary
      • Create a beneficiary
        POST
      • Retrieve a beneficiary
        GET
      • List all beneficiaries
        GET
      • Update a beneficiary
        POST
      • Delete a beneficiary
        DELETE
    • Payouts
      • Create a payout
        POST
      • Retrieve a Payout
        GET
      • Update a Payout
        POST
      • List All Payouts
        GET
  • Balance
    • Get balance
      GET
  • Products
    • Create a Product
      POST
    • Retrieve a product
      GET
    • Update a product
      POST
    • List all products
      GET
  • Prices
    • Create a price
      POST
    • Retrieve a price
      GET
    • Update a price
      POST
  • Payment Links
    • Create a payment link
      POST
    • Update a payment link
      POST
    • Retrieve payment link
      GET
    • List all payment links
      GET
    • Retrieve a payment link's line items
      GET
  • 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
  • Customers
    • Create a customer
      POST
    • Retrieve a customer
      GET
    • Update a customer
      POST
  • 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
  • Invoices
    • Create an invoice
      POST
    • Retrieve an invoice
      GET
    • Finalize an invoice
      POST
    • Send an invoice for manual payment
      POST
    • Delete a draft invoice
      GET
    • Void an invoice
      POST
    • List all invoices
      GET
    • Pay an invoice
      POST
  • Invoice Items
    • Create an invoice item
      POST
    • Retrieve an invoice item
      GET
  • Invoice Line Item
    • Bulk add invoice line items
      POST
  • Subscriptions
    • Create a subscription
      POST
    • Retrieve a subscription
      GET
    • Update a subscription
      POST
    • Cancel a subscription
      DELETE
    • List subscriptions
      GET
  • Subscription Items
    • Create a subscription item
      POST
    • Retrieve a subscription item
      GET
    • Delete a subscription item
      DELETE
  • Issuing
    • Authorizations
      • Retrieve an authorization
        GET
      • List all authorization
        GET
    • Cardholders
      • Create a cardholder
        POST
      • Update a cardholder
        POST
      • Retrieve a cardholder
        GET
      • List all cardholders
        GET
    • 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
        POST
      • Retrieve a transaction
        GET
      • List all transactions
        GET
  • Coupons
    • Create a Coupon
      POST
    • Retrieve a coupon
      GET
    • Delete a coupon
      DELETE
  • Promotion Code
    • Create a promotion code
      POST
    • Update a promotion code
      POST
  • Accounts
    • Retrieve account's paymentmethods
      GET
  1. Payment Methods

Create a PaymentMethod

Developing
POST
/v1/payment_methods
Instead of creating a PaymentMethod directly, we recommend using the PaymentIntents API to accept a payment immediately or the SetupIntent API to collect payment method details ahead of a future payment.

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 YWRtaW46MTIzNDU2
Header Params
Accept
string 
required
Default:
application/json
Content-Type
string 
required
Default:
application/json
Body Params application/json
metadata
object 
optional
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
billing_details
object (Billing Details) 
optional
Billing information associated with the PaymentMethod that may be used or required by particular types of payment methods.
address
object (Address) 
optional
email
string 
optional
Email address.
name
string 
optional
Full name.
phone
string 
optional
Billing phone number (including extension).
type
enum<string> 
required
The type of the PaymentMethod. An additional object is included on the PaymentMethod with a name matching this value. It contains additional information specific to the PaymentMethod type.
Allowed values:
cardalipayplusalipaywechat_paysepa_debitalipay_hkboosttruemoneygcashkakaopaytouchngorabbit_line_paydanaklarnaidealgiropaysofortepstrustlybancontactp24unionpayfpxmcashgrabpaybank_transfer_idqrispromptpayovoshopeepayupiboletopaynowpix9paystitchbpi
card
object 
optional
If this is a card PaymentMethod, this object contains the user’s card details.
brand
string 
optional
American Express, Diners Club, Discover, JCB, MasterCard, UnionPay, Visa, or Unknown
checks
object 
optional
country
string 
optional
Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you’ve collected.
exp_month
integer 
optional
Two-digit number representing the card’s expiration month.
exp_year
integer 
optional
Four-digit number representing the card’s expiration year.
fingerprint
string 
optional
Uniquely identifies this particular card number.
funding
string 
optional
Can be credit, debit, prepaid, or unknown.
last4
string 
optional
The last four digits of the card.
metadata
object 
optional
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
Example
{
  "metadata": {},
  "billing_details": {
    "address": {
      "city": "string",
      "country": "string",
      "line1": "string",
      "line2": "string",
      "postal_code": "string",
      "state": "string"
    },
    "email": "string",
    "name": "string",
    "phone": "string"
  },
  "type": "card",
  "card": {
    "brand": "string",
    "checks": {
      "address_line1_check": "string",
      "address_zip_check": "string",
      "cvc_check": "string"
    },
    "country": "string",
    "exp_month": 0,
    "exp_year": 0,
    "fingerprint": "string",
    "funding": "string",
    "last4": "string",
    "metadata": {}
  }
}

Request 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/payment_methods?members&reference&Type&_postman_listIndexKey=key&_postman_listAllowsMultipleValues' \
--data-raw ''

Responses

🟢200OK
application/json
Body
id
string 
optional
Unique identifier for the object, like 'pm_xxxxx'
object
string 
optional
'payment method'
created
integer 
optional
Time at which the object was created. Measured in seconds since the Unix epoch.
customer
string 
optional
The ID of the Customer to which this PaymentMethod is saved. This will not be set when the PaymentMethod has not been saved to a Customer.
metadata
object 
optional
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
livemode
boolean 
optional
Has the value true if the object exists in live mode or the value false if the object exists in test mode.
billing_details
object (Billing Details) 
optional
Billing information associated with the PaymentMethod that may be used or required by particular types of payment methods.
address
object (Address) 
optional
email
string 
optional
Email address.
name
string 
optional
Full name.
phone
string 
optional
Billing phone number (including extension).
type
enum<string> 
required
The type of the PaymentMethod. An additional object is included on the PaymentMethod with a name matching this value. It contains additional information specific to the PaymentMethod type.
Allowed values:
cardalipayplusalipaywechat_paysepa_debitalipay_hkboosttruemoneygcashkakaopaytouchngorabbit_line_paydanaklarnaidealgiropaysofortepstrustlybancontactp24unionpayfpxmcashgrabpaybank_transfer_idqrispromptpayovoshopeepayupiboletopaynowpix9paystitchbpi
card
object 
optional
If this is a card PaymentMethod, this object contains the user’s card details.
brand
string 
optional
American Express, Diners Club, Discover, JCB, MasterCard, UnionPay, Visa, or Unknown
checks
object 
optional
country
string 
optional
Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you’ve collected.
exp_month
integer 
optional
Two-digit number representing the card’s expiration month.
exp_year
integer 
optional
Four-digit number representing the card’s expiration year.
fingerprint
string 
optional
Uniquely identifies this particular card number.
funding
string 
optional
Can be credit, debit, prepaid, or unknown.
last4
string 
optional
The last four digits of the card.
metadata
object 
optional
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
Example
{
  "id": "string",
  "object": "string",
  "created": 0,
  "customer": "string",
  "metadata": {},
  "livemode": true,
  "billing_details": {
    "address": {
      "city": "string",
      "country": "string",
      "line1": "string",
      "line2": "string",
      "postal_code": "string",
      "state": "string"
    },
    "email": "string",
    "name": "string",
    "phone": "string"
  },
  "type": "card",
  "card": {
    "brand": "string",
    "checks": {
      "address_line1_check": "string",
      "address_zip_check": "string",
      "cvc_check": "string"
    },
    "country": "string",
    "exp_month": 0,
    "exp_year": 0,
    "fingerprint": "string",
    "funding": "string",
    "last4": "string",
    "metadata": {}
  }
}
Modified at 2024-07-04 03:28:59
Previous
List all charges
Next
Retrieve a PaymentMethod
Built with