PaymentIntent is created to help you through the 3DS flow of collecting payment from your customer. It is necessary only for implementing 3DS flow using Chargebee.js
Sample payment intent [ JSON ]
{
"amount": 5000,
"created_at": 1517479728,
"currency_code": "USD",
"expires_at": 1517481528,
"gateway": "chargebee",
"gateway_account_id": "gw___test__3Nl9RGqRcPqUhf2",
"id": "__test__3Nl9RLTRcPqUp95T__test__RPn0gcdsvkZRdHYu1mDu93JGuGAxcdJYGz",
"modified_at": 1568801328,
"object": "payment_intent",
"status": "inited"
}
API Index URL GET
https://{site}.chargebee.com/api/v1/payment_intents
string, max chars=150 Identifier for PaymentIntent.
enumerated string Current status of PaymentIntent. Possible values are
initedIntent is initialized.in_progressStatus will be in_progress if the Active Payment Attempt state is in requires_identification, requires_challenge or requires_redirection.authorized3DS verification successfully completed.consumedIf any Chargebee operation such as create subscription etc. is completed using the intent, it will be in consumed state. Intent cannot be used if it's already in consumed state.expiredIntent has expired, since it was not consumed before the predefined time-out.
initedIntent is initialized.in_progressStatus will be in_progress if the Active Payment Attempt state is in requires_identification, requires_challenge or requires_redirection.authorized3DS verification successfully completed.consumedIf any Chargebee operation such as create subscription etc. is completed using the intent, it will be in consumed state. Intent cannot be used if it's already in consumed state.
expiredIntent has expired, since it was not consumed before the predefined time-out.
Show all values[+]
optional, string, max chars=3 The currency code (ISO 4217 format) of the amount used in transaction.
in cents, min=0 Amount(in cents) to be authorized for 3DS flow.
string, max chars=50 The gateway account used for performing the 3DS flow.
timestamp(UTC) in seconds Timestamp indicating when the PaymentIntent will expire if left unconsumed.
optional, string, max chars=200 Reference for payment method at gateway. Only applicable when the PaymentIntent is created for cards stored in the gateway.
optional, string, max chars=250 The URL the customer will be directed to once 3DS verification is successful. Applicable only when payment_method_type
is ideal
, sofort
, dotpay
or giropay
.
optional, string, max chars=250 The URL the customer will be directed to when 3DS verification fails. Applicable only when payment_method_type
is ideal
, sofort
, dotpay
or giropay
.
timestamp(UTC) in seconds Timestamp indicating when the PaymentIntent was created.
timestamp(UTC) in seconds Timestamp indicating when the PaymentIntent was last modified.
string, max chars=50 The unique identifier of the customer for whom the payment_intent
will be created. If specified, the payment_intent
will be used exclusively for that customer. If not specified, the payment_intent
won’t be associated with any customer and will be available for any customer.
optional, string Gateway associated with the PaymentIntent. optional, payment_attempt
Active payment attempt for the PaymentIntent.
Active payment attempt attributes
optional, string, max chars=70 Identifier for PaymentIntent's active payment attempt.
enumerated string Current status of active payment attempt Possible values are
initedPayment attempt is initialized.requires_identificationCustomer's device fingerprint is used to verify their identity. It needs to be sent to the Issuing Bank for verification.requires_challengeThe transaction has to go through 3DS Challenge flow and the customer needs to authenticate via 3DS 2.0requires_redirectionThe transaction has to go through 3DS Redirection flow and the customer needs to authenticate via 3DS 1.0authorized3DS verification successfully completed.refused3DS verification attempt failed.pending_authorizationWaiting for the authorization.
initedPayment attempt is initialized.requires_identificationCustomer's device fingerprint is used to verify their identity. It needs to be sent to the Issuing Bank for verification.requires_challengeThe transaction has to go through 3DS Challenge flow and the customer needs to authenticate via 3DS 2.0requires_redirectionThe transaction has to go through 3DS Redirection flow and the customer needs to authenticate via 3DS 1.0
authorized3DS verification successfully completed.refused3DS verification attempt failed.pending_authorizationWaiting for the authorization.
Show all values[+]
optional, string, max chars=50 Reference of PaymentIntent at gateway
optional, string, max chars=100 Error code received from the payment gateway on failure.
optional, string, max chars=65k Error message received from the payment gateway on failure.
timestamp(UTC) in seconds Timestamp indicating when the active payment attempt was created.
timestamp(UTC) in seconds Timestamp indicating when the active payment attempt was last modified.
string, max chars=150 Identifier for PaymentIntent.
enumerated string Current status of PaymentIntent. Possible values are
initedIntent is initialized.in_progressStatus will be in_progress if the Active Payment Attempt state is in requires_identification, requires_challenge or requires_redirection.authorized3DS verification successfully completed.consumedIf any Chargebee operation such as create subscription etc. is completed using the intent, it will be in consumed state. Intent cannot be used if it's already in consumed state.expiredIntent has expired, since it was not consumed before the predefined time-out.
initedIntent is initialized.in_progressStatus will be in_progress if the Active Payment Attempt state is in requires_identification, requires_challenge or requires_redirection.authorized3DS verification successfully completed.consumedIf any Chargebee operation such as create subscription etc. is completed using the intent, it will be in consumed state. Intent cannot be used if it's already in consumed state.
expiredIntent has expired, since it was not consumed before the predefined time-out.
Show all values[+]
optional, string, max chars=3 The currency code (ISO 4217 format) of the amount used in transaction.
in cents, min=0 Amount(in cents) to be authorized for 3DS flow.
string, max chars=50 The gateway account used for performing the 3DS flow.
timestamp(UTC) in seconds Timestamp indicating when the PaymentIntent will expire if left unconsumed.
optional, string, max chars=200 Reference for payment method at gateway. Only applicable when the PaymentIntent is created for cards stored in the gateway.
optional, string, max chars=250 The URL the customer will be directed to once 3DS verification is successful. Applicable only when payment_method_type
is ideal
, sofort
, dotpay
or giropay
.
optional, string, max chars=250 The URL the customer will be directed to when 3DS verification fails. Applicable only when payment_method_type
is ideal
, sofort
, dotpay
or giropay
.
timestamp(UTC) in seconds Timestamp indicating when the PaymentIntent was created.
timestamp(UTC) in seconds Timestamp indicating when the PaymentIntent was last modified.
string, max chars=50 The unique identifier of the customer for whom the payment_intent
will be created. If specified, the payment_intent
will be used exclusively for that customer. If not specified, the payment_intent
won’t be associated with any customer and will be available for any customer.
optional, string Gateway associated with the PaymentIntent.
optional, payment_attempt Active payment attempt for the PaymentIntent. Creates a PaymentIntent object. This is to be used with Chargebee.js API to complete the 3DS flow for new or stored cards.
While creating, specify the appropriate gateway account and amount. Exact amount can be estimated using our Estimate API.
This API is not enabled for live sites by default. Please contact
support to get this enabled.
Sample Request
curl https://{site}.chargebee.com/api/v1/payment_intents \
-u {site_api_key}:\
-d amount=5000 \
-d currency_code="USD"
curl https://{site}.chargebee.com/api/v1/payment_intents \
-u {site_api_key}:\
-d amount=5000 \
-d currency_code="USD"
curl https://{site}.chargebee.com/api/v1/payment_intents \
-u {site_api_key}:\
-d amount=5000 \
-d currency_code="USD"
Sample Response [ JSON ]
Show more...
{
"payment_intent": {
"amount": 5000,
"created_at": 1517479728,
"currency_code": "USD",
"expires_at": 1517481528,
"gateway": "chargebee",
"gateway_account_id": "gw___test__3Nl9RGqRcPqUhf2",
"id": "__test__3Nl9RLTRcPqUp95T__test__RPn0gcdsvkZRdHYu1mDu93JGuGAxcdJYGz",
"modified_at": 1568801328,
"object": "payment_intent",
"status": "inited"
}
}
URL Format
POST
https://{site}.chargebee.com/api/v1/payment_intents
optional, string, max chars=50 The unique identifier of the customer for whom the payment_intent
will be created. If specified, the payment_intent
will be used exclusively for that customer. If not specified, the payment_intent
won’t be associated with any customer and will be available for any customer.
required, in cents, min=0 Amount(in cents) to be authorized for 3DS flow.
required, string, max chars=3 The currency code (ISO 4217 format) of the amount used in transaction.
optional, string, max chars=50 The gateway account used for performing the 3DS flow.
optional, string, max chars=200 Reference for payment method at gateway. Only applicable when the PaymentIntent is created for cards stored in the gateway.
optional, string, max chars=250 The URL the customer will be directed to once 3DS verification is successful. Applicable only when payment_method_type
is ideal
, sofort
, dotpay
or giropay
.
optional, string, max chars=250 The URL the customer will be directed to when 3DS verification fails. Applicable only when payment_method_type
is ideal
, sofort
, dotpay
or giropay
.
always returned required
Resource object representing payment_intent
Sample admin console URL
https://{site}.chargebee.com/admin-console/payment_intents/123x
Updating properties on a PaymentIntent object. All the subsequent 3DS transaction attempts will have the updated values.
This API is not enabled for live sites by default. Please contact
support to get this enabled.
Sample Request
curl https://{site}.chargebee.com/api/v1/payment_intents/__test__3Nl9RLTRcPqe8S5U__test__TvxVbiOu9KZfwtvCm36CX8lpqmeqUSEM \
-u {site_api_key}:\
-d amount=4000 \
-d currency_code="USD"
curl https://{site}.chargebee.com/api/v1/payment_intents/__test__3Nl9RLTRcPqe8S5U__test__TvxVbiOu9KZfwtvCm36CX8lpqmeqUSEM \
-u {site_api_key}:\
-d amount=4000 \
-d currency_code="USD"
curl https://{site}.chargebee.com/api/v1/payment_intents/__test__3Nl9RLTRcPqe8S5U__test__TvxVbiOu9KZfwtvCm36CX8lpqmeqUSEM \
-u {site_api_key}:\
-d amount=4000 \
-d currency_code="USD"
Sample Response [ JSON ]
Show more...
{
"payment_intent": {
"amount": 4000,
"created_at": 1517479764,
"currency_code": "USD",
"expires_at": 1517481564,
"gateway": "chargebee",
"gateway_account_id": "gw___test__3Nl9RDTRcPqczp2",
"id": "__test__3Nl9RLTRcPqe8S5U__test__TvxVbiOu9KZfwtvCm36CX8lpqmeqUSEM",
"modified_at": 1568801376,
"object": "payment_intent",
"status": "inited"
}
}
URL Format
POST
https://{site}.chargebee.com/api/v1/payment_intents/{payment-intent-id}
optional, in cents, min=0 Amount(in cents) to be authorized for 3DS flow.
optional, string, max chars=3 The currency code (ISO 4217 format) of the amount used in transaction.
optional, string, max chars=50 The gateway account used for performing the 3DS flow.
optional, string, max chars=250 The URL the customer will be directed to once 3DS verification is successful. Applicable only when payment_method_type
is ideal
, sofort
, dotpay
or giropay
.
optional, string, max chars=250 The URL the customer will be directed to when 3DS verification fails. Applicable only when payment_method_type
is ideal
, sofort
, dotpay
or giropay
.
always returned required
Resource object representing payment_intent
Sample admin console URL
https://{site}.chargebee.com/admin-console/payment_intents/123x
Retrieves the PaymentIntent resource.
This API is not enabled for live sites by default. Please contact
support to get this enabled.
Sample Request
curl https://{site}.chargebee.com/api/v1/payment_intents/__test__3Nl9RLTRcPqLy55S__test__ZyvWdyZ0cdD963AnCrZivHu2oFQFo8OJU \
-u {site_api_key}:
curl https://{site}.chargebee.com/api/v1/payment_intents/__test__3Nl9RLTRcPqLy55S__test__ZyvWdyZ0cdD963AnCrZivHu2oFQFo8OJU \
-u {site_api_key}:
curl https://{site}.chargebee.com/api/v1/payment_intents/__test__3Nl9RLTRcPqLy55S__test__ZyvWdyZ0cdD963AnCrZivHu2oFQFo8OJU \
-u {site_api_key}:
Sample Response [ JSON ]
Show more...
{
"payment_intent": {
"amount": 5000,
"created_at": 1517479694,
"currency_code": "USD",
"expires_at": 1517481494,
"gateway": "chargebee",
"gateway_account_id": "gw___test__3Nl9RGbRcPqLrS2",
"id": "__test__3Nl9RLTRcPqLy55S__test__ZyvWdyZ0cdD963AnCrZivHu2oFQFo8OJU",
"modified_at": 1568801294,
"object": "payment_intent",
"status": "inited"
}
}
URL Format
GET
https://{site}.chargebee.com/api/v1/payment_intents/{payment-intent-id}
always returned required
Resource object representing payment_intent
Sample admin console URL
https://{site}.chargebee.com/admin-console/payment_intents/123x