Errors

Gateways return the SDK's typed errors from github.com/laranex/go-myanmar-payments/v4. Each implements myanmarpayments.PaymentError, so one errors.As covers the package; match a single type with errors.As too.

Error	Returned when
*InvalidPaymentDataError	Payment data has values the gateway would reject
*APIError	A gateway rejects a request, answers with an error (including errors sent with HTTP 200), or cannot be reached
*SignatureVerificationError	A callback, return redirect or gateway response fails signature verification
*ConfigurationError	A gateway is requested without a setting it needs, or a time setting is not a whole number greater than 0

var paymentErr myanmarpayments.PaymentError
if errors.As(err, &paymentErr) {
	log.Printf("payment failed: %v", paymentErr)
}

Every message starts with myanmarpayments: , the Go convention; the rest matches the other Laranex packages.

The package adds its own sentinel errors; match them with errors.Is:

Error	Returned when
payments.ErrUnknownGateway	Manager.Gateway() or Manager.HandleCallback() gets a name other than kbz-pay, wave-money, aya-pay, yoma-mmqr or cyber-source
payments.ErrFormRouteDisabled	AutoSubmitURL() is called while form_route.enabled is false
payments.ErrCryptNotAvailable	AutoSubmitURL() is called without the crypt facade
payments.ErrInvalidFormLink	Manager.ResolveFormPayment() gets a tampered, foreign or expired link

InvalidPaymentDataError

import (
	"errors"

	myanmarpayments "github.com/laranex/go-myanmar-payments/v4"
	"github.com/laranex/go-myanmar-payments/v4/kbzpay"
)

_, err := kbz.PWA(ctx, kbzpay.PaymentData{
	OrderID:     "ORDER-1",
	Amount:      myanmarpayments.Kyat(0),
	CallbackURL: "https://shop.test/payments/kbz/callback",
})

var invalid *myanmarpayments.InvalidPaymentDataError
if errors.As(err, &invalid) {
	invalid.Errors
	// map[orderId:The orderId field may only contain ...
	//     amount:The amount field must be greater than 0.]
}

Validation runs inside the gateway call, before any request is sent. err.Error() is myanmarpayments: Invalid payment data: followed by the messages, in field-name order.

APIError

Field	Type	Description
GatewayCode	string	The gateway's error code, e.g. ORDER_ID_USED, 09, PAYMENT ALREADY EXISTS
GatewayMessage	string	The gateway's error message
HTTPStatus	int	HTTP status of the response, 0 when no response was received
Raw	map[string]any	The decoded response body

Message describes what failed, e.g. KBZ Pay precreate failed: [ORDER_ID_USED] Duplicate order; when the gateway sends a code without a message, it ends with the bracketed code. For a call that could not reach the gateway, Message is Could not reach <url>: … and Unwrap() returns the underlying transport error.

SignatureVerificationError

Raw holds the unverified payload. Log it, never act on it.

ConfigurationError

The message names the gateway and the key, e.g. myanmarpayments: The wave_money configuration is missing [merchant_id]., or myanmarpayments: The kbz_pay configuration [timeout_in_seconds] must be a whole number greater than 0. for a time setting, with Invalid set. Gateway and Key hold both. AutoSubmitURL returns it with form_route and ttl_minutes when the form link lifetime is missing or invalid.