SDK Go Didit untuk KYC, AML, dan Transaksi

Modul resmi Didit untuk Go. Modul ini membutuhkan Go 1.22 atau yang lebih baru dan hanya menggunakan pustaka standar. Lihat ikhtisar SDK server untuk mengetahui hal yang dimiliki bersama oleh setiap SDK.

Instalasi

go get github.com/didit-protocol/sdk-go

Modul ini ada di github.com/didit-protocol/sdk-go di pkg.go.dev. Sumber dan catatan perubahannya ada di didit-protocol/sdk-go di GitHub. Paketnya bernama didit. Webhook berada di github.com/didit-protocol/sdk-go/webhook, Authentication di .../authentication, dan opsi klien di .../option. Contoh pada setiap halaman referensi API berupa isi dari sebuah fungsi. Contoh tersebut menggunakan context, fmt dan log dari pustaka standar serta modul ini.

Konfigurasi klien

didit.NewClient() membaca DIDIT_API_KEY dari lingkungan. Berikan opsi untuk menimpanya, atau untuk mengatur ID organisasi dan aplikasi yang dibutuhkan panggilan dengan cakupan aplikasi (kasus, jaringan, laporan regulasi). Setiap opsi juga dapat dipakai pada satu panggilan saja.

package main

import (
	"context"
	"fmt"
	"log"
	"os"
	"time"

	"github.com/didit-protocol/sdk-go"
	"github.com/didit-protocol/sdk-go/option"
)

func main() {
	client := didit.NewClient(
		option.WithAPIKey(os.Getenv("DIDIT_API_KEY")),
		option.WithOrganizationID(os.Getenv("DIDIT_ORGANIZATION_ID")),
		option.WithApplicationID(os.Getenv("DIDIT_APPLICATION_ID")),
		option.WithTimeout(30*time.Second),
		option.WithMaxRetries(2),
	)

	// Options for a single call.
	decision, err := client.Sessions.RetrieveDecision(context.Background(), "11111111-2222-3333-4444-555555555555",
		didit.SessionsRetrieveDecisionParams{}, option.WithTimeout(5*time.Second))
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(decision.Status)
}

Kolom permintaan yang bersifat opsional adalah nilai didit.Opt. Isi kolom tersebut dengan didit.String, didit.Int, didit.Bool, didit.Float atau didit.Some, atau biarkan kosong agar tidak ada yang dikirim.

Membuat sesi

Buat sesi verifikasi untuk sebuah alur kerja, lalu arahkan pengguna Anda ke URL-nya.

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/didit-protocol/sdk-go"
)

func main() {
	client := didit.NewClient()

	session, err := client.Sessions.Create(context.Background(), didit.SessionsCreateParams{
		WorkflowID: "11111111-2222-3333-4444-555555555555",
		VendorData: didit.String("user-123"),
		Callback:   didit.String("https://example.com/verification/done"),
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(session.URL)
}

Membaca keputusan

Saat pengguna selesai (atau saat webhook diterima), baca keputusannya. Setiap hasil fitur berupa slice dengan satu entri untuk setiap node alur kerja.

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/didit-protocol/sdk-go"
)

func main() {
	client := didit.NewClient()

	decision, err := client.Sessions.RetrieveDecision(context.Background(), "11111111-2222-3333-4444-555555555555",
		didit.SessionsRetrieveDecisionParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(decision.Status)
	for _, verification := range decision.IDVerifications {
		fmt.Println(verification.Status)
	}
}

Memverifikasi webhook

Berikan byte isi mentah dan header permintaan. webhook.Verify mengembalikan *didit.WebhookVerificationError untuk setiap pengiriman yang tidak valid atau sudah kedaluwarsa, dan mengembalikan event bertipe jika pengiriman valid.

package main

import (
	"errors"
	"fmt"
	"io"
	"log"
	"net/http"
	"os"

	"github.com/didit-protocol/sdk-go"
	"github.com/didit-protocol/sdk-go/webhook"
)

func main() {
	secret := os.Getenv("DIDIT_WEBHOOK_SECRET")
	http.HandleFunc("POST /webhooks/didit", func(w http.ResponseWriter, r *http.Request) {
		body, err := io.ReadAll(http.MaxBytesReader(w, r.Body, 1<<20))
		if err != nil {
			http.Error(w, "bad body", http.StatusBadRequest)
			return
		}
		event, err := webhook.Verify(body, r.Header, secret)
		var invalid *didit.WebhookVerificationError
		if errors.As(err, &invalid) {
			http.Error(w, string(invalid.Reason), http.StatusBadRequest)
			return
		} else if err != nil {
			http.Error(w, "error", http.StatusInternalServerError)
			return
		}
		if e, ok := event.(*webhook.StatusUpdatedEvent); ok {
			fmt.Println(e.SessionID, e.Status)
		}
		w.WriteHeader(http.StatusOK)
	})
	log.Fatal(http.ListenAndServe(":8080", nil))
}

Selama Anda merotasi rahasia, tambahkan rahasia lama dengan webhook.WithSecrets. Lihat Webhook untuk event dan skema tanda tangannya.

Melakukan skrining transaksi

Kirim pembayaran, penarikan, atau transfer kripto ke Pemantauan Transaksi. Respons memuat status dan skor risikonya.

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/didit-protocol/sdk-go"
)

func main() {
	client := didit.NewClient()

	transaction, err := client.Transactions.Create(context.Background(), didit.TransactionsCreateParams{
		TransactionID:       "txn-1001",
		TransactionCategory: "finance",
		TransactionDetails: didit.TransactionsCreateParamsTransactionDetails{
			Direction: "outbound",
			Amount:    1500,
			Currency:  "EUR",
		},
		Subject: didit.TransactionsCreateParamsSubject{
			EntityType: didit.String("individual"),
			VendorData: "user-123",
			FullName:   "Maria Garcia",
		},
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(transaction.Status, transaction.Score)
}

Memverifikasi token Authentication

Paket authentication memeriksa token akses yang ditandatangani oleh penerbit Authentication Anda, di backend Anda, tanpa memanggil Didit untuk setiap permintaan. Paket ini juga menukar kode, menyegarkan token, memeriksa dan mencabut sesi, serta menjalankan peningkatan autentikasi.

Verifikasi token melakukan pemeriksaan yang dijelaskan dalam Verifikasi token di server Anda, terhadap penerbit dan kunci penandatanganan aplikasi Anda.

package main

import (
	"context"
	"errors"
	"fmt"
	"log"

	"github.com/didit-protocol/sdk-go"
	"github.com/didit-protocol/sdk-go/authentication"
)

func main() {
	// The publishable key (pk_live_... or pk_test_...) carries your issuer URL.
	auth, err := authentication.NewFromPublishableKey("pk_live_...", authentication.WithClientID("your-application-id"))
	if err != nil {
		log.Fatal(err)
	}

	claims, err := auth.VerifyAccessToken(context.Background(), "the bearer token")
	var invalid *didit.TokenVerificationError
	if errors.As(err, &invalid) {
		fmt.Println("rejected:", invalid.Reason)
		return
	} else if err != nil {
		log.Fatal(err)
	}
	fmt.Println(claims.Subject)
}

Galat

package main

import (
	"context"
	"errors"
	"fmt"

	"github.com/didit-protocol/sdk-go"
)

func main() {
	client := didit.NewClient()

	_, err := client.Sessions.RetrieveDecision(context.Background(), "11111111-2222-3333-4444-555555555555",
		didit.SessionsRetrieveDecisionParams{})
	var notFound *didit.NotFoundError
	var status *didit.APIStatusError
	switch {
	case errors.As(err, &notFound):
		fmt.Println("no such session")
	case errors.As(err, &status):
		fmt.Println(status.StatusCode, status.RequestID, status.Body)
	case err != nil:
		fmt.Println("no response:", err)
	}
}

Daftar dan berkas

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/didit-protocol/sdk-go"
)

func main() {
	ctx := context.Background()
	client := didit.NewClient()

	// Lists page through every result.
	iter := client.Sessions.ListAutoPaging(ctx, didit.SessionsListParams{Status: didit.String("Approved")})
	for iter.Next() {
		fmt.Println(iter.Current().SessionID)
	}
	if err := iter.Err(); err != nil {
		log.Fatal(err)
	}

	// Uploads take didit.FileFromPath, FileFromBytes or FileFromReader.
	result, err := client.IDVerification.Verify(ctx, didit.IDVerificationVerifyParams{
		FrontImage: didit.FileFromPath("id-front.jpg"),
		BackImage:  didit.Some(didit.FileFromPath("id-back.jpg")),
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(result.IDVerification.Status)
}

Endpoint yang belum ada di Go SDK

Go 1.0.1 dibuat sebelum endpoint berikut ditambahkan ke API, jadi tidak ada metode untuk endpoint tersebut dan halaman endpoint-nya tidak memiliki contoh Go:

Validasi alamat
Hapus transaksi secara batch
Jaringan Travel Rule: ambil jaringan, minta akses ke jaringan, serta ambil, simpan atau kirim kuesioner jaringan
Bukti dompet Travel Rule: daftar bukti dompet berupa tangkapan layar dan setujui atau tolak salah satunya
Google Wallet, yang belum ada di rilis 1.0.1 mana pun: mulai verifikasi Google Wallet dan kirim respons dompet

SDK ini juga tidak dapat mengirim kolom permintaan yang lebih baru berikut:

biometric_consent, tags dan user_state saat membuat sesi
biometric_consent_mode saat memperbarui konfigurasi webhook
beneficiary_vasp saat memperbarui transfer Travel Rule
confirm_delete, yang dibutuhkan saat menghapus laporan yang telah difinalisasi
16 kolom Validasi Database yang lebih baru yang belum ada di rilis 1.0.1 mana pun

Sampai rilis Go yang lebih baru menambahkannya, panggil endpoint-endpoint ini melalui HTTP seperti yang ditunjukkan permintaan cURL pada setiap halaman. Setiap halaman endpoint server lain di referensi API memiliki contoh Go untuk operasinya.

Panduan

Autentikasi

Model Context Protocol (MCP)

SDK Web

SDK Native

SDK Server

Integrasi

SDK Go Didit untuk KYC, AML, dan Transaksi

Instalasi

Konfigurasi klien

Membuat sesi

Membaca keputusan

Memverifikasi webhook

Melakukan skrining transaksi

Memverifikasi token Authentication

Galat

Daftar dan berkas

Endpoint yang belum ada di Go SDK

​Instalasi

​Konfigurasi klien

​Membuat sesi

​Membaca keputusan

​Memverifikasi webhook

​Melakukan skrining transaksi

​Memverifikasi token Authentication

​Galat

​Daftar dan berkas

​Endpoint yang belum ada di Go SDK

Instalasi

Konfigurasi klien

Membuat sesi

Membaca keputusan

Memverifikasi webhook

Melakukan skrining transaksi

Memverifikasi token Authentication

Galat

Daftar dan berkas

Endpoint yang belum ada di Go SDK