This object is the return value of the CreatePaymentFn.
numberThe amount (as an integer - i.e. $10 = 1000) that this payment is for.
Typically this should equal the Order total, unless multiple payment methods
are being used for the order.
Exclude<PaymentState, 'Error'>The PaymentState of the resulting Payment.
In a single-step payment flow, this should be set to 'Settled'.
In a two-step flow, this should be set to 'Authorized'.
If using a PaymentProcess, may be something else entirely according to your business logic.
stringThe unique payment reference code typically assigned by the payment provider.
stringIf the payment is declined or fails for ome other reason, pass the
relevant error message here, and it gets returned with the
ErrorResponse of the addPaymentToOrder mutation.
PaymentMetadataThis field can be used to store other relevant data which is often provided by the payment provider, such as security data related to the payment method or data used in troubleshooting or debugging.
Any data stored in the optional public property will be available
via the Shop API. This is useful for certain checkout flows such as
external gateways, where the payment provider returns a unique
url which must then be passed to the storefront app.
This object is the return value of the CreatePaymentFn when there has been an error.
This object is the return value of the CreateRefundFn.
This object is the return value of the SettlePaymentFn when the Payment has been successfully settled.
This object is the return value of the SettlePaymentFn when the Payment could not be settled.
falseExclude<PaymentState, 'Settled'>The state to transition this Payment to upon unsuccessful settlement.
Defaults to Error. Note that if using a different state, it must be
legal to transition to that state from the Authorized state according
to the PaymentState config (which can be customized using the
PaymentProcess).
stringThe message that will be returned when attempting to settle the payment, and will
also be persisted as Payment.errorMessage.
PaymentMetadataThis object is the return value of the CancelPaymentFn when the Payment has been successfully cancelled.
This object is the return value of the CancelPaymentFn when the Payment could not be cancelled.
falseExclude<PaymentState, 'Cancelled'>The state to transition this Payment to upon unsuccessful cancellation.
Defaults to Error. Note that if using a different state, it must be
legal to transition to that state from the Authorized state according
to the PaymentState config (which can be customized using the
PaymentProcess).
stringThe message that will be returned when attempting to cancel the payment, and will
also be persisted as Payment.errorMessage.
PaymentMetadataThis function contains the logic for creating a payment. See PaymentMethodHandler for an example.
Returns a CreatePaymentResult.
This function contains the logic for settling a payment. See PaymentMethodHandler for an example.
This function contains the logic for cancelling a payment. See PaymentMethodHandler for an example.
This function contains the logic for creating a refund. See PaymentMethodHandler for an example.
Architecture reviews, custom plugin work, migrations, ongoing support. Get a hand from the team that builds Vendure.
Talk to the team