API-SDK-Go

This is an Go SDK that maps some of the RESTful methods of Open API that are documented at doc.revenuemonster.my.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

The golang version 1.11 and above

Covered Functions

• Signature Algorithm
• Client Credentials (Authentication)
• Refresh Token (Authentication)
• Get Merchant Profile
• Get Merchant Subscriptions
• Get Stores
• Get Stores By ID
• Create Store
• Update Store
• Delete Store
• Get User Profile
• Payment (Transaction QR) - Create Transaction QRCode/URL
• [] Payment (Transaction QR) - Get Transaction QRCode/URL
• Payment (Transaction QR) - Get Transaction QRCode/URL By Code
• Payment (Transaction QR) - Get Transactions By Code
• Payment (Quick Pay) - Payment
• Payment (Quick Pay) - Refund
• Payment (Quick Pay) - Reverse
• Payment (Quick Pay) - Get All Payment Transactions
• Payment (Quick Pay) - Get All Payment Transaction By ID
• [] Payment (Quick Pay) - Get All Payment Transaction By OrderID
• Payment (Quick Pay) - Daily Settlement Report
• Give Loyalty Point
• Get Loyalty Members
• Get Loyalty Member
• Get Loyalty Member Point History
• Issue Voucher
• Void Voucher
• Get Voucher By Code
• Get Voucher Batches
• Get Voucher Batch By Key
• Send Notification (Merchant)
• Send Notification (Store)
• Send Notification (User)
• Sms Sending
• Create Delivery
• Get Delivery By Id
• Calculate Delivery Fee
• Ekyc - MyKad Recognition
• EKyc - Face Comparison
• Ekyc - Liveness Verification

Usage

1. "sandbox" is for sandbox environment.
2. "production" is for production environment.
3. Get Client ID and Client Secret from portal.
4. Generate private key and publci key from portal.
5. Store private key for own use and public key at portal.
6. Set environment variables at begining of the project before using any of the library functions.

Environment environment = new Environment();
environment.setEnvironment(clientId, clientSecret, "sandbox");

• Sample to read private key file

• Client Credentials (Authentication)
  • To get refresh token and access token(expired after 2 hours) with using provided clientId and clientSecret

• Authorization Code (Authentication)
  • To get authorization code which a partner wants to request permission to develop an application of a merchant and exchange authorization code into access token and refresh token

  oauthURL := sdk.NewClient(sdk.Client{
    ID:         "123456789",
    Secret:     "123456789",
    IsSandbox:  true,
    PrivateKey: []byte(`---private key---`),
    PublicKey:  []byte(`---public key---`),
  }).GetAuthorizationCodeURL(
    "123456789",
    "http://google.com",
    "manage_payment",
    "manage_store",
  )

• Refresh Token (Authentication)
  • To get new access token(expired after 2 hours) with using provided clientId and clientSecret (recommended to schedule to run this fucntion on every less than 2 hours) in order to avoid expired access token error

• Create Transaction QRCode/URL (TransactionQR)
  • To create static/dynamic QR code for user scanning merchant's displayed QR

• Get Transaction QRCode/URL (TransactionQR)
  • To get all QR Code(s) generated previously in the system

• Get Transaction QRCode/URL By Code (TransactionQR)
  • To get specific QR Code generated previously in the system, by passing in code in query parameter (/qrcode/...)

• Get Transactions By Code (TransactionQR)
  • To get all transactions under existing QR code, by passing in code in query parameter (/qrcode/.../transactions)

• Payment (Quick Pay) - Payment
  • To make payment by scanning barcode/authcode from user

• Payment (Quick Pay) - Refund
  • To refund the successful transactions

• Payment (Quick Pay) - Reverse
  • To reverse time-out or problematic transaction

• Payment (Quick Pay) - Get Payment Transaction By ID
  • To get details of a transaction by using transactionId

• Payment (Quick Pay) - Get Payment Transaction By Order ID
  • To get details of a transaction by using orderId

• Push Notification ( Store ) - Send Notificaiton To Store By Store ID

sdk.NewClient(sdk.Client{
    ID:         "123456789",
    Secret:     "123456789",
    IsSandbox:  true,
    PrivateKey: []byte(`---private key---`),
    PublicKey:  []byte(`---public key---`),
}).PushNotificationToStore(sdk.RequestPushNotificationToStore{
    StoreID: "123123123",
    Title:   "Notification Title",
    Body:    "Notification Body",
})

• Sms Sending - Send Sms To Specified Phone Number

sdk.NewClient(sdk.Client{
    ID:         "123456789",
    Secret:     "123456789",
    IsSandbox:  true,
    PrivateKey: []byte(`---private key---`),
    PublicKey:  []byte(`---public key---`),
}).SendSms(sdk.RequestSendSms{
    CountryCode: "60",
    PhoneNumber: "187824152",
    Message: "Some message",
    Type: sdk.MessageTypeTAC,
})

• Create Delivery - Create delivery

pointOne := sdk.DeliveryPoint{
    Address: "",
    EntraceNumber: "",
    FloorNumber: "",
    BuildingNumber: "",
    Remark: "",
    Contact: sdk.DeliveryPointContact{
        Name: "",
        PhoneNumber: "",
    },
}

pointTwo := sdk.DeliveryPoint{
    Address: "",
    EntraceNumber: "",
    FloorNumber: "",
    BuildingNumber: "",
    Remark: "",
    Contact: sdk.DeliveryPointContact{
        Name: "",
        PhoneNumber: "",
    },
}

sdk.NewClient(sdk.Client{
    ID:         "123456789",
    Secret:     "123456789",
    IsSandbox:  true,
    PrivateKey: []byte(`---private key---`),
    PublicKey:  []byte(`---public key---`),
}).CreateDelivery(sdk.RequestCreateDelivery{
    DeliveryVendor: sdk.DeliveryVendor{
        Vendor: sdk.VendorTypeMrSpeedy,
        Credential: "",
    },
    VehicleType: sdk.VehicleTypeMotobike,
    Type: sdk.DeliveryTypeDocument,
    IsCashAccount: true,
    Points: []sdk.DeliveryContact{pointOne, pointTwo},
})

• Calculate Delivery Fee - Calculate delivery fee before delivery is made

pointOne := sdk.DeliveryPoint{
    Address: "",
    EntraceNumber: "",
    FloorNumber: "",
    BuildingNumber: "",
    Remark: "",
    Contact: sdk.DeliveryPointContact{
        Name: "",
        PhoneNumber: "",
    },
}

pointTwo := sdk.DeliveryPoint{
    Address: "",
    EntraceNumber: "",
    FloorNumber: "",
    BuildingNumber: "",
    Remark: "",
    Contact: sdk.DeliveryPointContact{
        Name: "",
        PhoneNumber: "",
    },
}

sdk.NewClient(sdk.Client{
    ID:         "123456789",
    Secret:     "123456789",
    IsSandbox:  true,
    PrivateKey: []byte(`---private key---`),
    PublicKey:  []byte(`---public key---`),
}).CalculateDeliveryFee(sdk.RequestCalculateDeliveryFee{
    DeliveryVendor: sdk.DeliveryVendor{
        Vendor: sdk.VendorTypeMrSpeedy,
        Credential: "",
    },
    VehicleType: sdk.VehicleTypeMotobike,
    Type: sdk.DeliveryTypeDocument,
    IsCashAccount: true,
    Points: []sdk.DeliveryContact{pointOne, pointTwo},
})

• Get Delivery - Get delivery by id

sdk.NewClient(sdk.Client{
    ID:         "123456789",
    Secret:     "123456789",
    IsSandbox:  true,
    PrivateKey: []byte(`---private key---`),
    PublicKey:  []byte(`---public key---`),
}).GetDeliveryByID("1")

• Ekyc - MyKad Recognition

sdk.NewClient(sdk.Client{
    ID:         "123456789",
    Secret:     "123456789",
    IsSandbox:  true,
    PrivateKey:  []byte(`---private key---`),
    AccessToken: `access token`,
}).EkycMyKad(sdk.RequestEkycMykad{
    Image: `base64 image`, // an image that contains MyKad
    NotifyUrl: `https://your-backend-notify-path` // a POST request handler to receive ekyc result
})

• Ekyc - Face Comparison

sdk.NewClient(sdk.Client{
    ID:         "123456789",
    Secret:     "123456789",
    IsSandbox:  true,
    PrivateKey:  []byte(`---private key---`),
    AccessToken: `access token`,
}).EkycMyKad(sdk.RequestEkycFaceCompare{
    Image1: `base64 image`, // an image that contains a face
    Image2: `base64 image`, // an image that contains a face
})

• Ekyc - Liveness Verification

sdk.NewClient(sdk.Client{
    ID:         "123456789",
    Secret:     "123456789",
    IsSandbox:  true,
    PrivateKey:  []byte(`---private key---`),
    AccessToken: `access token`,
}).EkycLiveness(sdk.RequestEkycLiveness{
    Image:          `base64 image`, // an image that contains a face
    MykadRequestID: `123456789`, // request ID from MyKad Recognition
})

• Ekyc - Get Mykad Result

sdk.NewClient(sdk.Client{
    ID:         "123456789",
    Secret:     "123456789",
    IsSandbox:  true,
    PrivateKey:  []byte(`---private key---`),
    AccessToken: `access token`,
}).GetMykadResult(sdk.RequestGetMykadResult{
    ID:          `123456789`, // the mykad request id
})

• Ekyc - Get Landmarks Info

sdk.NewClient(sdk.Client{
    ID:         "123456789",
    Secret:     "123456789",
    IsSandbox:  true,
    PrivateKey:  []byte(`---private key---`),
    AccessToken: `access token`,
}).GetLandmarkInfo(sdk.RequestGetLandmarkInfo{
    ID:          `123456789`, // the mykad request id
    Includes: ["msc_logo", "malaysia_flag"], // optional parameter to specify landmark types to be acquired
})

• Ekyc - Get eKYC Result

sdk.NewClient(sdk.Client{
    ID:         "123456789",
    Secret:     "123456789",
    IsSandbox:  true,
    PrivateKey:  []byte(`---private key---`),
    AccessToken: `access token`,
}).GetEkycResult(sdk.RequestGetEkycResult{
    ID:          `123456789`, // the ekycId obtained after liveness verification
    Includes: ["mykadImage", "selfieImage"], // optional parameter to obtain request images
})