kernelorderv1

type CompleteOrderPaymentRequest struct {

	// trade_no is the payment record's trade number
	// (v2_payment_record.trade_no), at most 120 bytes.
	TradeNo string `protobuf:"bytes,1,opt,name=trade_no,json=tradeNo,proto3" json:"trade_no,omitempty"`
	// order_id is the order the record names (v2_payment_record.order_id).
	OrderId uint64 `protobuf:"varint,2,opt,name=order_id,json=orderId,proto3" json:"order_id,omitempty"`
	// contains filtered or unexported fields
}

type CompleteOrderPaymentResponse struct {

	// applied is false when the trade number was applied before; the other
	// fields then describe that first application.
	Applied bool                `protobuf:"varint,1,opt,name=applied,proto3" json:"applied,omitempty"`
	OrderId uint64              `protobuf:"varint,2,opt,name=order_id,json=orderId,proto3" json:"order_id,omitempty"`
	Outcome OrderPaymentOutcome `protobuf:"varint,3,opt,name=outcome,proto3,enum=anixops.kernelorder.v1.OrderPaymentOutcome" json:"outcome,omitempty"`
	// reason says why a REFUSED record does not pay its order.
	Reason string `protobuf:"bytes,4,opt,name=reason,proto3" json:"reason,omitempty"`
	// contains filtered or unexported fields
}

type KernelOrderClient interface {
	// CompleteOrderPayment applies a paid payment record to the order it
	// names, as the kernel's payment callbacks do. The payment module first
	// records the payment (the record's status, gateway trade number and
	// notify data, and its gateway's statistics) in its own tables and
	// commits, then calls this. The kernel reads the record itself and, in
	// one transaction:
	//  1. requires the record to be paid and to name order_id;
	//  2. re-checks that the record pays the order: the order exists, is the
	//     record's user's, is still pending, and the record's amount covers
	//     its total. Otherwise the order is left unchanged and the outcome
	//     is REFUSED;
	//  3. marks the order paid;
	//  4. completes it: grants its plan with request id "order:<order id>"
	//     and marks it completed. If the grant fails, the order stays paid
	//     for an administrator to complete and the outcome is PAID.
	//
	// It is idempotent per trade number: the outcome is recorded with request
	// id "payment:<trade_no>" in the kernel's request ledger, and a repeat
	// answers the first outcome with applied false.
	//
	// NOT_FOUND when no record has the trade number; FAILED_PRECONDITION when
	// the record is not paid or names another order (nothing is recorded, a
	// later call may apply).
	CompleteOrderPayment(ctx context.Context, in *CompleteOrderPaymentRequest, opts ...grpc.CallOption) (*CompleteOrderPaymentResponse, error)
}

type KernelOrderServer interface {
	// CompleteOrderPayment applies a paid payment record to the order it
	// names, as the kernel's payment callbacks do. The payment module first
	// records the payment (the record's status, gateway trade number and
	// notify data, and its gateway's statistics) in its own tables and
	// commits, then calls this. The kernel reads the record itself and, in
	// one transaction:
	//  1. requires the record to be paid and to name order_id;
	//  2. re-checks that the record pays the order: the order exists, is the
	//     record's user's, is still pending, and the record's amount covers
	//     its total. Otherwise the order is left unchanged and the outcome
	//     is REFUSED;
	//  3. marks the order paid;
	//  4. completes it: grants its plan with request id "order:<order id>"
	//     and marks it completed. If the grant fails, the order stays paid
	//     for an administrator to complete and the outcome is PAID.
	//
	// It is idempotent per trade number: the outcome is recorded with request
	// id "payment:<trade_no>" in the kernel's request ledger, and a repeat
	// answers the first outcome with applied false.
	//
	// NOT_FOUND when no record has the trade number; FAILED_PRECONDITION when
	// the record is not paid or names another order (nothing is recorded, a
	// later call may apply).
	CompleteOrderPayment(context.Context, *CompleteOrderPaymentRequest) (*CompleteOrderPaymentResponse, error)
	// contains filtered or unexported methods
}

type OrderPaymentOutcome int32

type UnimplementedKernelOrderServer struct{}

type UnsafeKernelOrderServer interface {
	// contains filtered or unexported methods
}