Elastic Path Payments Powered by Stripe
The Elastic Path Payments Powered by Stripe integration supports the following payment methods:
authorizecaptureconfirmpurchaserefund
note
You can contact Elastic Path sales or customer success team to get more information about Elastic Path Payments powered by Stripe and to check whether it will work for you.
Authorization or Purchase - POST Pay using token or source
https://api.moltin.com/v2/orders/:orderId/payments
Parameters
Path parameters
| Name | Required | Type | Description |
|---|---|---|---|
orderId | Required | string | The Universally Unique Identifier (UUID) of the order that you want to pay for. |
Headers
| Name | Required | Type | Description |
|---|---|---|---|
Authorization | Required | string | The Bearer token required to get access to the API. |
Body
| Name | Required | Type | Description |
|---|---|---|---|
options.idempotency_key | Optional | string | Provides the option to send a Stripe Idempotency Key. |
options.receipt_email | Optional | string | Provides the email address to which you want to send the Stripe receipts for the transactions within the store. This feature is available only in the live mode. |
payment | Required | string | Specifies the Stripe token or source. |
options.customer | Optional | string | Specifies the Stripe customer ID. This is required if you want to send a source. |
method | Required | string | Specifies the transaction method, such as purchase or authorize. |
amount | Optional | integer | Specifies the amount to be paid for the transaction. |
gateway | Required | string | Specifies the gateway. You must use elastic_path_payments_stripe as the required gateway. |
Request examples
We recommend that you use the payment method or source with Stripe payments. For more information about generating a payment method on the client-side, see the Stripe Elements documentation.
important
When you pass source instead of a token, ensure that you include the Stripe customer ID in the request.
note
If you are using Stripe API, pass your Stripe-Account ID in the header to make the payment. For example, see the following request:
curl https://api.stripe.com/v1/payment_methods \
-u pk_live_EP_STRIPE_PUBLISHABLE_KEY: \
-H Stripe-Account:acct_xxxxxxx\
-d type=card \
-d "card[number]"=xxxxxxxxxxxx \
-d "card[exp_month]"=6 \
-d "card[exp_year]"=2023 \
-d "card[cvc]"=314
Curl
curl -X POST https://api.moltin.com/v2/orders/:orderId/payments \
-H "Authorization: Bearer XXXX" \
-d $'{
"data": {
"gateway": "elastic_path_payments_stripe",
"method": "purchase",
"amount": 5499,
"payment": "pm_card_threeDSecureRequired",
"options": {
"receipt_email": "john@example.com"
}
}
}'
JavaScript SDK
const MoltinGateway = require('@moltin/sdk').gateway
const Moltin = MoltinGateway({
client_id: 'X'
})
const id = 'XXXX'
const payment = {
gateway: 'elastic_path_payments_stripe',
method: 'purchase',
payment: 'pm_card_threeDSecureRequired'
}
Moltin.Orders.Payment(id, payment).then(() => {
// Do something
})
Response example
201 Created
note
The x values in the "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" are replaced with the returned values.
{
"data": {
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "transaction",
"reference": "pi_xxxxxxxxxxxxx",
"gateway": "elastic_path_payments_stripe",
"amount": 5499,
"currency": "USD",
"transaction-type": "purchase",
"transaction_type": "purchase",
"status": "pending",
"relationships": {
"order": {
"data": {
"type": "order",
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
}
},
"meta": {
"display_price": {
"amount": 5499,
"currency": "USD",
"formatted": "$54.99"
},
"display_refunded_amount": {
"total": {
"amount": 0,
"currency": "USD",
"formatted": "$0.00"
}
},
"created_at": "2019-08-28T10:40:21.925Z",
"timestamps": {
"created_at": "2019-08-28T10:40:21Z",
"updated_at": "2019-08-28T10:40:23Z"
}
},
"client_parameters": {
"token": "pi_xxxxxxxxxxxxxxxx",
"secret": "pi_xxxxxxxxxxxxxx_secret_xxxxxxxxxxxxxx"
}
}
}
Authorization or Purchase - POST Pay using Stripe Payment Element
https://api.moltin.com/v2/orders/:orderId/payments
Parameters
Path parameters
| Name | Required | Type | Description |
|---|---|---|---|
orderId | Required | string | The Universally Unique Identifier (UUID) of the order that you want to pay for. |
Headers
| Name | Required | Type | Description |
|---|---|---|---|
Authorization | Required | string | The Bearer token required to get access to the API. |
Body
| Name | Required | Type | Description |
|---|---|---|---|
gateway | Required | string | Specifies the gateway. You must use elastic_path_payments_stripe as the required gateway. |
method | Required | string | Specifies the transaction method, such as purchase or authorize. |
options.receipt_email | Optional | string | Provides the email address to which you want to send the Stripe receipts for the transactions within the store. This feature is available only in the live mode. |
payment_method_types | Required | string | Specifies the Stripe payment method types configured for the store. See https://stripe.com/docs/api/payment_intents/create#create_payment_intent-payment_method_types |
Request examples
Curl
curl -X POST https://api.moltin.com/v2/orders/:orderId/payments \
-H "Authorization: Bearer XXXX" \
-d $'{
"data": {
"gateway": "elastic_path_payments_stripe",
"method": "purchase",
"options": {
"receipt_email": "john@example.com"
},
"payment_method_types": ["link", "card"]
}
}'
JavaScript SDK
const MoltinGateway = require('@moltin/sdk').gateway
const Moltin = MoltinGateway({
client_id: 'X'
})
const id = 'XXXX'
const payment = {
gateway: 'elastic_path_payments_stripe',
method: 'purchase',
options: {
receipt_email: "john@example.com"
},
payment_method_types: ["link", "card"],
}
Moltin.Orders.Payment(id, payment).then(() => {
// Do something
})
Response example
201 Created
{
"data": {
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "transaction",
"reference": "pi_xxxxxxxxxxxxxx",
"gateway": "elastic_path_payments_stripe",
"amount": 20000,
"refunded_amount": 0,
"currency": "USD",
"transaction_type": "purchase-setup",
"status": "pending",
"relationships": {
"order": {
"data": {
"type": "order",
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
}
},
"meta": {
"display_price": {
"amount": 20000,
"currency": "USD",
"formatted": "$200.00"
},
"display_refunded_amount": {
"total": {
"amount": 0,
"currency": "USD",
"formatted": "$0.00"
}
},
"timestamps": {
"created_at": "2022-07-18T22:16:11Z",
"updated_at": "2022-07-18T22:16:32Z"
}
},
"client_parameters": {
"token": "pi_xxxxxxxxxxxxxx",
"secret": "pi_xxxxxxxxxxxxxx_secret_xxxxxxxxxxxxxx"
},
"payment_intent": {
"amount": 20000,
"amount_capturable": 0,
"amount_details": {
"tip": {}
},
"amount_received": 0,
"application": "ca_xxxxxxxxxxxxxx",
"application_fee_amount": null,
"automatic_payment_methods": null,
"canceled_at": null,
"cancellation_reason": null,
"capture_method": "manual",
"charges": {
"data": [],
"has_more": false,
"object": "list",
"total_count": 0,
"url": "/v1/charges?payment_intent=pi_xxxxxxxxxxxxxx"
},
"client_secret": "pi_xxxxxxxxxxxxxx_secret_xxxxxxxxxxxxxx",
"confirmation_method": "automatic",
"created": 1658182571,
"currency": "usd",
"customer": null,
"description": null,
"id": "pi_xxxxxxxxxxxxxx",
"invoice": null,
"last_payment_error": null,
"livemode": false,
"metadata": {
"email": "andy@example.com",
"ip_address": "##.###.###.###",
"order_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
},
"next_action": null,
"object": "payment_intent",
"on_behalf_of": null,
"payment_method": null,
"payment_method_options": {
"link": {
"persistent_token": null
}
},
"payment_method_types": [
"link"
],
"processing": null,
"receipt_email": "john@example.com",
"review": null,
"setup_future_usage": null,
"shipping": null,
"source": null,
"statement_descriptor": null,
"statement_descriptor_suffix": null,
"status": "requires_payment_method",
"transfer_data": null,
"transfer_group": null
}
}
}
Confirmation - POST Confirm the security validation succeeded
https://api.moltin.com/v2/orders/:orderId/transactions/:transactionId/confirm
Parameters
Path parameters
| Name | Required | Type | Description |
|---|---|---|---|
orderId | Required | string | The UUID of the order that you want to pay for. |
transactionId | Required | string | The UUID of the transaction that requires client action to process validation. |
Headers
| Name | Required | Type | Description |
|---|---|---|---|
Authorization | Required | string | The Bearer token required to get access to the API. |
Request example
If the response for the authorization or purchase request consists of client_parameters, Stripe might required client action to perform a 3D Secure validation. Use the Stripe client libraries and process the 3D Secure validation. When the validation succeeds, continue the payment processing by making a request as in the following example:
curl -X POST https://api.moltin.com/v2/orders/:orderId/transactions/:transactionId/confirm \
-H "Authorization: Bearer XXXX" \
-d $'{
"data": {
}
}'
Response example
201 Created
note
The x values in the "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" are replaced with the returned values.
{
"data": {
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "transaction",
"reference": "xxxxxx",
"gateway": "elastic_path_payments_stripe",
"amount": 100,
"currency": "USD",
"transaction_type": "purchase",
"status": "complete",
"relationships": {
"order": {
"data": {
"type": "order",
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
}
},
"meta": {
"display_price": {
"amount": 100,
"currency": "USD",
"formatted": "$100.00"
},
"display_refunded_amount": {
"total": {
"amount": 0,
"currency": "USD",
"formatted": "$0.00"
}
},
"timestamps": {
"created_at": "2020-05-25T20:58:57Z",
"updated_at": "2020-05-25T13:59:01-07:00"
}
}
}
}
Confirmation - POST Capture the payment authorization
https://api.moltin.com/v2/orders/:orderId/transactions/:transactionId/capture
Use this endpoint to capture a transaction initiated by the shopper. Usually capture does not occur at the same time as authorization. For more information, see the Capture section.
Parameters
Path parameters
| Name | Required | Type | Description |
|---|---|---|---|
orderId | Required | string | The UUID of the order that you want to pay for. |
transactionId | Required | string | The UUID of the successful transaction for this payment. |
Headers
| Name | Required | Type | Description |
|---|---|---|---|
Authorization | Required | string | The Bearer token required to get access to the API. |
Request example
curl -X POST https://api.moltin.com/v2/orders/:orderId/transactions/:transactionId/capture \
-H "Authorization: Bearer XXXX"
Response example
201 Created
note
The x values in the "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" are replaced with the returned values.
{
"data": {
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "transaction",
"reference": "xxxxxx",
"gateway": "elastic_path_payments_stripe",
"amount": 100,
"currency": "USD",
"transaction_type": "capture",
"status": "complete",
"relationships": {
"order": {
"data": {
"type": "order",
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
}
},
"meta": {
"display_price": {
"amount": 100,
"currency": "USD",
"formatted": "$100.00"
},
"display_refunded_amount": {
"total": {
"amount": 0,
"currency": "USD",
"formatted": "$0.00"
}
},
"timestamps": {
"created_at": "2020-05-25T20:58:57Z",
"updated_at": "2020-05-25T13:59:01-07:00"
}
}
}
}
Refund - Post Refund the Payment
https://api.moltin.com/v2/orders/:orderId/transactions/:transactionId/refund
Use this endpoint to refund the amount initiated by the shopper.
Parameters
Path parameters
| Name | Required | Type | Description |
|---|---|---|---|
orderId | Required | string | The UUID of the order that you want to pay for. |
transactionId | Required | string | The UUID of the successful transaction for this payment. |
Headers
| Name | Required | Type | Description |
|---|---|---|---|
Authorization | Required | string | The Bearer token required to get access to the API. |
Body
| Name | Required | Type | Description |
|---|---|---|---|
amount | Required | integer | Specifies the amount to be refunded. |
options.note_to_payer | Optional | string | Specifies the reason for the refund. It appears in both the transaction history of the payer and the emails that the payer receives. |
Request Example
curl -X POST https://api.moltin.com/v2/orders/:orderId/transactions/:transactionId/refund \
-H "Authorization: Bearer XXXX"
"data": {
"amount": 1,
"options": {
"note_to_payer": "Test note to payer"
}
}
}
Response example
200 OK
{
"data": {
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "transaction",
"reference": "pi_3Kr4EBHGgiZNYgWz1eio9cFS",
"gateway": "elastic_path_payments_stripe",
"amount": 80000,
"refunded_amount": 2,
"refund_mechanism": "automatic",
"currency": "GBP",
"transaction_type": "refund",
"status": "complete",
"relationships": {
"order": {
"data": {
"type": "order",
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
}
},
"meta": {
"display_price": {
"amount": 80000,
"currency": "GBP",
"formatted": "£800.00"
},
"display_refunded_amount": {
"total": {
"amount": 2,
"currency": "GBP",
"formatted": "£0.02"
}
},
"timestamps": {
"created_at": "2022-04-21T17:55:38Z",
"updated_at": "2022-04-22T15:37:07Z"
}
}
}
}