irankish

README

IranKish Payment Gateway API for Go

The package is used for payments using Iranian IranKish payment gateway

Install

go get -u github.com/aliforever/go-irankish-api

Usage

Variables:

merchantID := "" // <-- Replace
sha1Key := "" // <-- Replace

ik := irankish.New(merchanID, sha1Key)

• MakeToken:

invoiceID := ""
amount := 0
callbackUrl := ""

token := ik.NewToken(invoiceID, amount, callbackUrl)

result, err := token.Make()
if err != nil {
	fmt.Println(err)
	return
}

fmt.Println(result)

After making token you can write a simple redirecting form as a html to redirect users to the gateway:

htmlForm := ik.SimpleFromRedirectingToGateway(token) // <- Token Received from Make Token Method

Also, you can either handle incoming POST requests from the gateway yourself or use a channel and package's handler:

payments := make(chan *irankish.CallbackData)
go func() {
    for data := range payments {
        fmt.Println(data)
        data.WriteResponse([]byte("payment result"))
    }   
}

http.HandleFunc("/verify", ik.CallbackHandler(callbacks))
http.ListenAndServe(":8001", nil)

• VerifyPayment:

token := ""
referenceNumber := ""

result, err := i.VerifyPayment(token, referenceNumber)
if err != nil {
    fmt.Println(err)
    return
}
fmt.Println(result)

Documentation

Index

• type CallbackData
  • func (c *CallbackData) TranslateResultCode() string
  • func (c *CallbackData) WriteResponse(data []byte)
• type IranKish
  • func New(merchantID, sha1Key string) *IranKish
  • func (i *IranKish) CallbackHandler(data chan<- CallbackData) (handler func(w http.ResponseWriter, r *http.Request))
  • func (i *IranKish) NewToken(invoiceID string, amount int64, callbackUrl string) *token
  • func (i *IranKish) SimpleFromRedirectingToGateway(token string) string
  • func (i *IranKish) VerifyPayment(token string, referenceNumber int64) (*VerifyPaymentResult, error)
• type MakeTokenResult
• type VerifyPaymentResult
  • func (v *VerifyPaymentResult) TranslateResultCode() string

Types

type CallbackData

type CallbackData struct {
	Token         string
	MerchantID    string
	AcceptorID    string
	ResultCode    string
	InvoiceNumber string
	PaymentID     string
	Amount        string
	ReferenceID   string
	CardNo        string
	// contains filtered or unexported fields
}

func (*CallbackData) TranslateResultCode

func (c *CallbackData) TranslateResultCode() string

func (*CallbackData) WriteResponse

func (c *CallbackData) WriteResponse(data []byte)

type IranKish

type IranKish struct {
	// contains filtered or unexported fields
}

func New

func New(merchantID, sha1Key string) *IranKish

func (*IranKish) CallbackHandler

func (i *IranKish) CallbackHandler(data chan<- CallbackData) (handler func(w http.ResponseWriter, r *http.Request))

func (*IranKish) NewToken

func (i *IranKish) NewToken(invoiceID string, amount int64, callbackUrl string) *token

func (*IranKish) SimpleFromRedirectingToGateway

func (i *IranKish) SimpleFromRedirectingToGateway(token string) string

func (*IranKish) VerifyPayment

func (i *IranKish) VerifyPayment(token string, referenceNumber int64) (*VerifyPaymentResult, error)

type MakeTokenResult

type MakeTokenResult struct {
	Message string
	Result  bool
	Token   string
}

type VerifyPaymentResult

type VerifyPaymentResult struct {
	Result string
}

func (*VerifyPaymentResult) TranslateResultCode

func (v *VerifyPaymentResult) TranslateResultCode() string