Payment Method Types
CreatePaymentResult
This object is the return value of the CreatePaymentFn.
Signature
interface CreatePaymentResult {
amount: number;
state: Exclude<PaymentState, 'Error'>;
transactionId?: string;
errorMessage?: string;
metadata?: PaymentMetadata;
}
Members
amount
number
1000
) that this payment is for.
Typically this should equal the Order total, unless multiple payment methods
are being used for the order.
state
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'
.
transactionId
string
errorMessage
string
addPaymentToOrder
mutation.
metadata
PaymentMetadata
This 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.
CreatePaymentErrorResult
This object is the return value of the CreatePaymentFn when there has been an error.
Signature
interface CreatePaymentErrorResult {
amount: number;
state: 'Error';
transactionId?: string;
errorMessage: string;
metadata?: PaymentMetadata;
}
Members
amount
number
state
'Error'
transactionId
string
errorMessage
string
metadata
PaymentMetadata
CreateRefundResult
This object is the return value of the CreateRefundFn.
Signature
interface CreateRefundResult {
state: RefundState;
transactionId?: string;
metadata?: PaymentMetadata;
}
Members
state
RefundState
transactionId
string
metadata
PaymentMetadata
SettlePaymentResult
This object is the return value of the SettlePaymentFn
Signature
interface SettlePaymentResult {
success: boolean;
errorMessage?: string;
metadata?: PaymentMetadata;
}
Members
success
boolean
errorMessage
string
metadata
PaymentMetadata
CreatePaymentFn
This function contains the logic for creating a payment. See PaymentMethodHandler for an example.
Returns a CreatePaymentResult.
Signature
type CreatePaymentFn<T extends ConfigArgs> = (
ctx: RequestContext,
order: Order,
amount: number,
args: ConfigArgValues<T>,
metadata: PaymentMetadata,
) => CreatePaymentResult | CreatePaymentErrorResult | Promise<CreatePaymentResult | CreatePaymentErrorResult>
SettlePaymentFn
This function contains the logic for settling a payment. See PaymentMethodHandler for an example.
Signature
type SettlePaymentFn<T extends ConfigArgs> = (
ctx: RequestContext,
order: Order,
payment: Payment,
args: ConfigArgValues<T>,
) => SettlePaymentResult | Promise<SettlePaymentResult>
CreateRefundFn
This function contains the logic for creating a refund. See PaymentMethodHandler for an example.
Signature
type CreateRefundFn<T extends ConfigArgs> = (
ctx: RequestContext,
input: RefundOrderInput,
amount: number,
order: Order,
payment: Payment,
args: ConfigArgValues<T>,
) => CreateRefundResult | Promise<CreateRefundResult>