Create subscription
Subscribe a buyer to a plan. This generates an acceptance link that the buyer must use to confirm and set up their payment method.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
"01G65Z755AFWAKHE12NY0CQ9FH"
"01JNRVWWHH68E76V3TMFFT6GHJ"
Body
Your internal subscription/order ID for tracking and correlation. Use this to match Confío subscriptions with your system's records.
128"36285414"
Optional first charge amount in cents (only for the first charge)
x >= 03000000
Optional redirect URI after subscription payment
"https://example.com/subscription-status"
Optional moment after which the subscription can no longer be accepted. Must be between 1 hour and 30 days from creation. Defaults to 7 days from creation.
"2024-01-22T10:30:00Z"
Response
Successfully created subscription.
Subscription's resource name
"stores/01JNRRDZDPH40DB2YRW329BFXM/subscription-plans/01JNRVWWHH68E76V3TMFFT6GHJ/subscriptions/01JNRVWWHH68E76V3TMFFT6GHJ"
Subscription status
PENDING_ACCEPTANCE, ACTIVE, PROCESSING, TRIALING, PAST_DUE, CANCELED, EXPIRED, SUSPENDED "PENDING_ACCEPTANCE"
Buyer information
Creation timestamp
"2024-01-15T10:30:00Z"
Your internal subscription/order ID, as provided when the subscription was created.
"36285414"
Optional first charge amount in cents (only for the first charge)
3000000
Optional redirect URI after subscription payment
"https://example.com/subscription-status"
URL for buyer to accept the subscription (only available when status is PENDING_ACCEPTANCE)
"https://checkout.confiopagos.com/s/abc123token"
Moment after which the subscription can no longer be accepted. Only meaningful while the status is PENDING_ACCEPTANCE.
"2024-01-22T10:30:00Z"
Start of current billing period
"2024-01-15T10:30:00Z"
End of current billing period
"2024-02-15T10:30:00Z"
Next billing date
"2024-02-15T10:30:00Z"