WooshPay OpenAPI
Product DocumentAPI ReferenceJS SDK ReferenceSaaS Platform Integration
Product DocumentAPI ReferenceJS SDK ReferenceSaaS Platform Integration
Back to WooshPay Website
  1. Setup Intents
  • 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
    • 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
  • Refunds
    • Create a refund
    • Retrieve a refund
  • Webhooks
    • Create a Webhook
    • List All Webhooks
    • Retrieve a Webhook
    • Delete a Webhook
    • Update a Webhook
  • Events
    • Types of events
    • Retrieve an event
  • Files
    • Files
    • Create a file
    • Retrieve a file
  • Disputes
    • Retrieve a dispute
    • Update a dispute
    • Close a dispute
    • List all disputes
  • Payouts
    • Beneficiary
      • Create a beneficiary
      • Retrieve a beneficiary
      • List all beneficiaries
      • Update a beneficiary
      • Delete a beneficiary
    • Payouts
      • Create a payout
      • Retrieve a Payout
      • Update a Payout
      • List All Payouts
  • 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
  • Checkout
    • Create a Session
    • Expire a Session
    • Retreive a Session
    • List All Checkout Sessions
    • Retrieve a Checkout Session's line items
    • Expire a Session Copy
  • Customers
    • Create a customer
    • Retrieve a customer
    • Update a customer
  • Invoices
    • 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
    • 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
    • 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
      • Update a card
      • Retrieve a card
      • List all cards
      • Retrieve card remaining limits
    • 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. Setup Intents

Update a SetupIntent

POST
/v1/setup_intents/{id}

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 *****************
Path Params
id
string 
required
Header Params
Accept
string 
required
Default:
application/json
Content-Type
string 
required
Default:
application/json
Body Params application/json
customer
string 
optional
ID of the Customer this SetupIntent belongs to, if one exists. If present, the SetupIntent’s payment method will be attached to the Customer on successful setup. Payment methods attached to other Customers cannot be used with this SetupIntent.
description
string 
optional
An arbitrary string attached to the object. Often useful for displaying to users.
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.
payment_method
string 
optional
ID of the payment method used with this SetupIntent.
payment_method_types
array[string]
optional
The list of payment method types (e.g. card) that this SetupIntent is allowed to set up.
payment_method_options
object 
optional
Payment-method-specific configuration for this SetupIntent.
card
object 
optional
payment_method_data
object 
optional
When included, this hash creates a PaymentMethod that is set as the payment_method value in the SetupIntent.
type
enum<string> 
required
The type of the PaymentMethod.
Allowed values:
cardalipayplusalipaywechat_paysepa_debitalipay_hkboosttruemoneygcashkakaopaytouchngorabbit_line_paydanaklarnaidealgiropaysofortepstrustlybancontactp24unionpayfpxmcashgrabpaybank_transfer_idqrispromptpayovoshopeepayupiboletopaynowpix9paystitchbpi
billing_details
object (Billing Details) 
optional
Billing information associated with the PaymentMethod that may be used or required by particular types of payment methods.
card
object 
optional
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.
wechat_pay
object 
optional
alipayplus
object 
optional
Example
{
    "customer": "string",
    "description": "string",
    "metadata": {},
    "payment_method": "string",
    "payment_method_types": [
        "string"
    ],
    "payment_method_options": {
        "card": {
            "request_three_d_secure": "string"
        }
    },
    "payment_method_data": {
        "type": "card",
        "billing_details": {
            "address": {
                "city": "string",
                "country": "string",
                "line1": "string",
                "line2": "string",
                "postal_code": "string",
                "state": "string"
            },
            "email": "string",
            "name": "string",
            "phone": "string"
        },
        "card": {
            "exp_month": "string",
            "exp_year": "string",
            "number": "string",
            "cvc": "string",
            "name": "string"
        },
        "wechat_pay": {
            "payment_code": "string"
        },
        "alipayplus": {
            "payment_code": "string"
        }
    }
}

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/setup_intents/' \
--header 'Accept;' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
    "customer": "string",
    "description": "string",
    "metadata": {},
    "payment_method": "string",
    "payment_method_types": [
        "string"
    ],
    "payment_method_options": {
        "card": {
            "request_three_d_secure": "string"
        }
    },
    "payment_method_data": {
        "type": "card",
        "billing_details": {
            "address": {
                "city": "string",
                "country": "string",
                "line1": "string",
                "line2": "string",
                "postal_code": "string",
                "state": "string"
            },
            "email": "string",
            "name": "string",
            "phone": "string"
        },
        "card": {
            "exp_month": "string",
            "exp_year": "string",
            "number": "string",
            "cvc": "string",
            "name": "string"
        },
        "wechat_pay": {
            "payment_code": "string"
        },
        "alipayplus": {
            "payment_code": "string"
        }
    }
}'

Responses

🟢200OK
application/json
Body
id
string 
optional
[RETRIEVABLE WITH PK] Unique identifier for the object, like ""seti_xxxxx".
object
string 
optional
[RETRIEVABLE WITH PK] "setup_intent"
cancellation_reason
string 
optional
[RETRIEVABLE WITH PK] Reason for cancellation of this SetupIntent, one of abandoned, requested_by_customer, or duplicate.
client_secret
string 
optional
[RETRIEVABLE WITH PK] The client secret of this SetupIntent. Used for client-side retrieval using a publishable key. The client secret can be used to complete payment setup from your frontend. It should not be stored, logged, or exposed to anyone other than the customer. Make sure that you have TLS enabled on any page that includes the client secret.
created
integer 
optional
[RETRIEVABLE WITH PK] Time at which the object was created. Measured in seconds since the Unix epoch.
customer
string 
optional
[EXPANDABLE] ID of the Customer this SetupIntent belongs to, if one exists. If present, the SetupIntent’s payment method will be attached to the Customer on successful setup. Payment methods attached to other Customers cannot be used with this SetupIntent.
description
string 
optional
[RETRIEVABLE WITH PK] An arbitrary string attached to the object. Often useful for displaying to users.
last_setup_error
object 
optional
[RETRIEVABLE WITH PK] The error encountered in the previous SetupIntent confirmation.
code
string 
required
For some errors that could be handled programmatically, a short string indicating the error code reported.
decline_code
string 
required
For card errors resulting from a card issuer decline, a short string indicating the card issuer’s reason for the decline if they provide one.
message
string 
required
A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.
param
string 
required
If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
payment_method
object 
optional
The PaymentMethod object for errors returned on a request involving a PaymentMethod.
payment_method_type
string 
required
If the error is specific to the type of payment method, the payment method type that had a problem.
type
string 
required
The type of error returned. One of api_error, card_error, idempotency_error, or invalid_request_error
latest_attempt
string 
optional
[EXPANDABLE] The most recent SetupAttempt for this SetupIntent.
livemode
boolean 
optional
[RETRIEVABLE WITH PK] Has the value true if the object exists in live mode or the value false if the object exists in test mode.
mandate
string 
optional
[EXPANDABLE] ID of the multi use Mandate generated by the SetupIntent.
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.
next_action
object (Next Action) 
optional
[RETRIEVABLE WITH PK] If present, this property tells you what actions you need to take in order for your customer to continue payment setup.
type
string 
optional
Type of the next action to perform
redirect_to_url
object 
optional
ddc_redirect
object 
optional
challenge_redirect
object 
optional
alipayplus_handle_redirect
object 
optional
alipay_handle_redirect
object 
optional
wechat_pay_display_qr_code
object 
optional
wechat_pay_redirect_to_android_app
object 
optional
wechat_pay_redirect_to_ios_app
object 
optional
wechat_pay_redirect_to_web
object 
optional
wechat_pay_official_account_params
object 
optional
truemoney_handle_redirect
object 
optional
akulaku_handle_redirect
object 
optional
bank_transfer_id_handle_redirect
object 
optional
promptpay_handle_redirect
object 
optional
dana_handle_redirect
object 
optional
shopeepay_handle_redirect
object 
optional
gcash_handle_redirect
object 
optional
rabbit_line_pay_handle_redirect
object 
optional
alipay_hk_handle_redirect
object 
optional
bpi_handle_redirect
object 
optional
pix_handle_redirect
object 
optional
oxxo_handle_redirect
object 
optional
spei_display_details
object 
optional
payment_method
string 
optional
[EXPANDABLE][RETRIEVABLE WITH PK] ID of the payment method used with this SetupIntent.
payment_method_options
object 
optional
Payment-method-specific configuration for this SetupIntent.
card
object 
optional
payment_method_types
array[string]
optional
The list of payment method types (e.g. card) that this SetupIntent is allowed to set up.
single_use_mandate
string 
optional
[EXPANDABLE] ID of the single_use Mandate generated by the SetupIntent.
status
string 
optional
[RETRIEVABLE WITH PK] Status of this SetupIntent, one of requires_payment_method, requires_confirmation, requires_action, processing, canceled, or succeeded.
return_url
string 
optional
The url that the cutomer will be redirected to.
Example
{
    "id": "string",
    "object": "string",
    "cancellation_reason": "string",
    "client_secret": "string",
    "created": 0,
    "customer": "string",
    "description": "string",
    "last_setup_error": {
        "code": "string",
        "decline_code": "string",
        "message": "string",
        "param": "string",
        "payment_method": {
            "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": {}
            }
        },
        "payment_method_type": "string",
        "type": "string"
    },
    "latest_attempt": "string",
    "livemode": true,
    "mandate": "string",
    "metadata": {},
    "next_action": {
        "type": "string",
        "redirect_to_url": {
            "return_url": "string",
            "url": "string"
        },
        "ddc_redirect": {
            "return_url": "string",
            "url": "string"
        },
        "challenge_redirect": {
            "return_url": "string",
            "url": "string"
        },
        "alipayplus_handle_redirect": {
            "return_url": "string",
            "schemeUrl": "string",
            "applinkUrl": "string",
            "normalUrl": "string"
        },
        "alipay_handle_redirect": {
            "native_data": "string",
            "native_url": "string",
            "return_url": "string",
            "url": "string"
        },
        "wechat_pay_display_qr_code": {
            "data": "string",
            "data_ur": "string",
            "image_url_png": "string",
            "image_url_svg": "string"
        },
        "wechat_pay_redirect_to_android_app": {
            "native_url": "string"
        },
        "wechat_pay_redirect_to_ios_app": {
            "native_url": "string"
        },
        "wechat_pay_redirect_to_web": {
            "url": "string"
        },
        "wechat_pay_official_account_params": {
            "appId": "string",
            "timeStamp": "string",
            "nonceStr": "string",
            "signType": "string",
            "paySign": "string",
            "package": "string"
        },
        "truemoney_handle_redirect": {
            "url": "string"
        },
        "akulaku_handle_redirect": {
            "url": "string"
        },
        "bank_transfer_id_handle_redirect": {
            "url": "string"
        },
        "promptpay_handle_redirect": {
            "url": "string"
        },
        "dana_handle_redirect": {
            "url": "string"
        },
        "shopeepay_handle_redirect": {
            "url": "string"
        },
        "gcash_handle_redirect": {
            "url": "string"
        },
        "rabbit_line_pay_handle_redirect": {
            "url": "string"
        },
        "alipay_hk_handle_redirect": {
            "url": "string"
        },
        "bpi_handle_redirect": {
            "url": "string"
        },
        "pix_handle_redirect": {
            "url": "string",
            "qrcode": "string",
            "timeout": 0
        },
        "oxxo_handle_redirect": {
            "timeout": "string",
            "bar_code": "string",
            "url": "string"
        },
        "spei_display_details": {}
    },
    "payment_method": "string",
    "payment_method_options": {
        "card": {
            "request_three_d_secure": "string"
        }
    },
    "payment_method_types": [
        "string"
    ],
    "single_use_mandate": "string",
    "status": "string",
    "return_url": "string"
}
Modified at 2023-01-28 08:29:31
Previous
List all SetupAttempts
Next
Confirm a SetupIntent
Built with