Hey Nalysa,

How do you notify your payment gateway of your callback URL? Is it globally registered in the payment gateway portal and shared by all orders? Or do you pass the callback URL per transaction when you tell the gateway about the payment your about to send it?

Matt

Hi Matt,

The callback URL is globally registered in the payment gateway portal, so I don't need to pass the callback URL per transaction.

Nalysa

Hi Matt,

I've put the order reference as a meta data entry.

return new PaymentFormResult()
{
    MetaData = new Dictionary<string, string>
    {
        { "orderReference", order.GenerateOrderReference()}
    },
    Form = new PaymentForm(paymentFormLink, FormMethod.Get)
};

However, I'm still a little confused about how to get and return this order reference on GetOrderReference method. Can you provide me with sample code or further explanation for my GetOrderReference method implementation?

Thanks

Hi Nalysa,

Sorry, you need to record that as meta data on the payment for the 3rd party payment system, not for Vendr. Then, when your callback is triggered, it will first hit the GetOrderReference method where you should then extract this from the info the 3rd party sends you, his will then tell Vendr what order it relates to and it will then hit your callback URL to complete the order finalization.

Matt

This is how the Stripe payment provider does it.

https://github.com/vendrhub/vendr-payment-provider-stripe/blob/dev/src/Vendr.PaymentProviders.Stripe/StripeCheckoutPaymentProvider.cs#L255

When it it setting up the payment details to send to stripe, it adds the order reference as meta data + as the ClientReferenceId on the payment. Then in GetOrderReference it parses it back out so that Vendr then knows which order the callback relates to.

https://github.com/vendrhub/vendr-payment-provider-stripe/blob/dev/src/Vendr.PaymentProviders.Stripe/StripePaymentProviderBase.cs#L51

Matt

Thanks Matt, I got it

Unfortunately, I faced another issue. After returning the transaction info on ProcessCallback(), the order was successfully created on Vendr store but the order status is Error (payment status is Captured) so that after the payment process, the checkout page got redirected to /cart/ instead of /checkout/order-confirmation/. Could you help me solve this?

return CallbackResult.Ok(
    new TransactionInfo
    {
        AmountAuthorized = AmountFromMinorUnits(payment.PaidAmount),
        PaymentStatus = GetPaymentStatus(payment.Status),
        TransactionId = payment.Id,
        TransactionFee = payment.FeesPaidAmount
    }
);

Hi Nalysa,

The order is set to the Error state when the continue URL is called and generally only goes into the Error order status for a number of reasons.

1) FinalizeAtContinueUrl is set to true on the payment provider which subsequently calls the ProcessCallback and this either returned a BadRequest HTTP response

2) The order being processed didn't match the order reference Vendr expected it to, which usually occurs if you are sent to the confirmation URL of an order that is not the order that Vendr retrieved.

3) The order payment status is of type Error

4) The order has it's order status set the error order status as defined in the store settings

You'll want to check to see if any of the above are true and if so look into why that is the case and rectify it.

Hope this helps

Matt

Thanks Matt, removing the TransactionFee make it works.

Anyway, what's the best way to handle an expired invoice? The payment gateway will send a callback when an invoice has expired (it's optional actually). I try to create a TransactionInfo with Cancelled payment status, but apparently the user still get the order confirmation email, which I think it should be an order cancellation email. Should I enable the callback for expired invoices or just leave it as is?

Best regards

Hi Nalysa,

Vendr automatically sends a confirmation when an order finalized, but a finalized order isn't necessarily captured. You should maybe check in the confirmation email template what the status of the order is and change the wording depending on the status.

If you need to send other emails when the payment status changes you'll need to use Vendr's event system to listen for these changes and send the appropriate email (you can define your own emails, and use the email template service to send them).

https://vendr.net/docs/core/1-3-0/key-concepts/events/

Hope this helps

Matt

Thanks Matt, really appreciate your helps.

Best regards, Nalysa