Ayoconnect Direct Debit Go SDK

This library contains ayoconnect direct debit v2 sdk for Go.

Overview

API that have implemented in this sdk:

Feature	Implemented
Generate B2B Access Token	✅
Generate B2B2C Access Token	✅
Get Auth Code	✅
OTP Verification	❌
Registration Account Binding	✅
Registration Account Unbinding	✅
Debit Charge Host To Host	✅
Get Card List	❌

List Of Public API

type ClientInterface interface {
	GetBusinessAccessToken(ctx context.Context) (*GetAccessTokenResponse, error)
	AccountBinding(ctx context.Context, req *AccountBindingRequest, b2bToken, externalID string) (*AccountBindingResponse, error)
	GetAuthCode(ctx context.Context, req *GetAuthCodeRequest, b2bToken, externalID string) (*GetAuthCodeResponse, error)
	GetCustomerAccessToken(ctx context.Context, authCode, accessTokenB2B string) (*GetAccessTokenResponse, error)
	Debit(ctx context.Context, req *DebitRequest, b2bToken, b2b2cToken, externalID string) (*DebitResponse, error)
	Unbind(ctx context.Context, req *AccountUnbindRequest, b2bToken, b2b2cToken, externalID string) (*AccountUnbindResponse, error)
	DebitStatus(ctx context.Context, b2bToken, debitExternalID, externalID string) (*DebitResponse, error)
}

Note: OTP Based Account Binding / Unbinding / Debit currently not implemented yet. any PR are welcome.

Flow

Card Binding Flow

List of API Used:

Generate B2B Access Token
Get Auth Code
Registration Account Binding

Debit Flow (Non OTP)

List of API Used:

Generate B2B Access Token
Generate B2B2C Access Token
Debit Charge Host To Host

Installation

go get github.com/praswicaksono/ayoconnect-direct-debit-go

Then simply use import

import github.com/praswicaksono/ayoconnect-direct-debit-go/directdebit

If you find any error please run go mod tidy to clear your go.mod file

Configuration

You may configure the sdk by passing a Config struct to the New function. Here list configuration options:

type Config struct {
	ClientID        string
	ClientSecret    string
	MerchantID      string
	RsaPrivateKey   string
	EndpointBaseURL string
	ChannelID       string
	Logger          *slog.Logger
	HTTPClient      *http.Client
}

To instantiante new client you can pass configuration to New function

package example

import "github.com/praswicaksono/ayoconnect-direct-debit-go/directdebit"

func main() {
    cfg := &directdebit.Config{
		RsaPrivateKey: privkey,
		ClientID:      "123",
		MerchantID:    "123",
		HTTPClient:    &http.Client{},
		Logger:        slog.Default(),
	}

	client, _ := directdebit.New(cfg)
}

Example

Get B2B Access Token

package example

import (
	"context"
	"log/slog"
	"net/http"

	"github.com/praswicaksono/ayoconnect-direct-debit-go/directdebit"
)

func genearetB2BToken() string {
    // private key must be in PKCS8 Format
	privkey := `-----BEGIN RSA PRIVATE KEY-----
MIIBOgIBAAJBAJ9wKHG/JDCr+6eZ6as5hHspDhZEUkveTF9GnCcDqRVmS/E4rhYw
niRfSSf2hfp516cYpC7zJ2AFB4id63T3lxECAwEAAQJALk7qQFdvEH/zYPOwTd4v
34HGKKuBZ63Sat3cXuyOQLt3OSj/lgRx/XELRjdLMADQrxTI0ijUvr9jqLB0I6O1
DQIhAMo3voVyYA0dmZvNWPRf6JzkFeexsXKmsrpNij9pwvPHAiEAyde1FPNTAeQn
e0DW+gtE5dHg/omiZDYBKLBj4jb4bmcCIDhvSjqP6wJ+CkqTCopY4eA3P23EB5PJ
tgOMdFKyP3gtAiEAgC0db2p94guTDvBEFJGndRJtAPdCSsUIw2AQbg1egi0CIH+a
Z4Mar+3f+SFIElF+M+aD4AzzibGUJghJ03cbR6Pt
-----END RSA PRIVATE KEY-----`

	cfg := &directdebit.Config{
		RsaPrivateKey: privkey,
		ClientID:      "123",
		MerchantID:    "123",
		HTTPClient:    &http.Client{},
		Logger:        slog.Default(),
	}

	client, _ := directdebit.New(cfg)
	resp, err := client.GetBusinessAccessToken(context.Background())
	if err != nil {
		slog.Error(err.Error())
		return ""
	}

	return resp.AccessToken
}

Contributing

If you would like to contribute please read our contributing guidelines. Any form of contribution is welcome.

praswicaksono / ayoconnect-direct-debit-go