Checkout credit card payment

POST

/api/v1/payments/credit_card

Initiate a credit card payment session.

Request Body ^required

StartPaymentRequest

Request model for initiating a Stripe payment session.

object

organization_id

Any of:

integer

integer

null

null

credit_plan_id

required

Credit Plan Id

The ID of the credit plan being purchased.

integer

quantity

Quantity

The quantity of the credit plan being purchased.

integer

default: 1

success_url

required

Success Url

The URL to redirect to after a successful payment (e.g., https://staging.gen.pro/success-payment).

string

cancel_url

required

Cancel Url

The URL to redirect to if the payment is cancelled (e.g., https://staging.gen.pro/cancel-payment).

string

agent_id

Any of:

string

string

null

null

social_account_identifier

Any of:

string

string

null

null

Responses

200

Successful Response

StartPaymentResponse

Response model containing the generated payment link.

object

payment_link

required

Payment Link

The Stripe checkout session URL for the user to complete the payment.

string

400

Bad Request

ErrorResponse

object

detail

Any of:

string

string

null

null

error

Any of:

string

string

null

null

error_code

Any of:

string

string

null

null

404

Not Found

ErrorResponse

object

detail

Any of:

string

string

null

null

error

Any of:

string

string

null

null

error_code

Any of:

string

string

null

null

422

Invalid redirect URLs, organization not found/not owner, plan already active, or invalid payment option.

ErrorResponse

object

detail

Any of:

string

string

null

null

error

Any of:

string

string

null

null

error_code

Any of:

string

string

null

null

Example

{
  "error": "Plan already active for this organization",
  "error_code": "plan_already_active"
}

500

Internal Server Error

ErrorResponse

object

detail

Any of:

string

string

null

null

error

Any of:

string

string

null

null

error_code

Any of:

string

string

null

null