Attach a new Payment Method to the organization

POST /api/payment/intent

Attach (Create or Update if not created already) a new payment method to the Organization. The payment method must be already associated to the PaymentProvider (Stripe) customer, this method will just associate that payment method to the current Gatego subscription

Headers

  • X-Gatego-oid

    Specify effective organization_id for Admin and Group Organization Admins. This is a global header for all endpoints only taken into consideration when it makes sense (it won't be used in Auth, for example)

application/json

Body

  • amount integer(int64)

    Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the smallest currency unit (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or equivalent in charge currency. The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99)

  • currency string

    Three-letter ISO currency code, in lowercase. Must be a supported currency.

  • description string

    An arbitrary string attached to the object.

  • error_on_requires_action boolean

    Set to true to fail the payment attempt if the PaymentIntent transitions into requires_action. This parameter is intended for simpler integrations that do not handle customer actions, like saving cards without authentication . This parameter can only be used with confirm=true

  • payment_method integer(int64)

    ID of the payment method (a PaymentMethod, Card, or compatible Source object) to attach to this PaymentIntent. If this parameter is omitted with confirm=true, customer.default_source will be attached as this PaymentIntent’s payment instrument to improve the migration experience for users of the Charges API. We recommend that you explicitly provide the payment_method going forward

  • receipt_email string

    Email address that the receipt for the resulting payment will be sent to. If receipt_email is specified for a payment in live mode, a receipt will be sent regardless of your email settings.

Responses

  • • 200

    OK

    Hide response attribute Show response attribute object
    • client_secret string

      Secret needed to securely complete the payment process
  • • 201

    Created

  • • 401

    Unauthorized

  • • 403

    Forbidden

  • • 404

    Not Found

POST /api/payment/intent 
curl \
 -X POST https://api-dev.gatego.io:443/api/payment/intent \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"amount":42,"currency":"string","description":"string","error_on_requires_action":false,"payment_method":42,"receipt_email":"string"}'
Request example 
# Headers

# Payload
{
  "amount": 42,
  "currency": "string",
  "description": "string",
  "error_on_requires_action": false,
  "payment_method": 42,
  "receipt_email": "string"
}
Response examples (200) 
{
  "client_secret": "string"
}