Files
zeekay 7d727874d5 chore: rebrand Formance Payments -> Hanzo Payments (hanzo-fi)
- go.mod module path + all self-imports: github.com/formancehq/payments -> github.com/hanzo-fi/payments
  (1590 .go files / 3152 refs; 20 modules: root, pkg/client, pkg/domain, 18 ce/plugins).
  External dep kept: formancehq/go-libs.
- plugins: each ce/plugins/* consumed a *published* pkg/domain; added local
  'replace .../pkg/domain => ../../../pkg/domain' (consistent with root) so every
  standalone plugin module builds in-monorepo. compile-plugin.sh MOD var rebranded too.
- branding: README, LICENSE (dual MIT+EE; upstream copyright retained + Hanzo added),
  goreleaser (release images -> registry.hanzo.ai/hanzo-fi, OCI labels, homepage),
  proto go_package, renovate, speakeasy gen.yaml, connector-template *.gotpl.
- CI: removed Numary/Formance workflows + composite action; added canonical hanzo.yml +
  cicd.yml (hanzoai/ci, gated HANZO_CI_ENABLED) + secretless ci.yml (go build/vet).
- kept as data/compat keys: wire capability enums ALLOW_FORMANCE_*, generated SDK type
  client.Formance, domain field FormanceRedirectURL, OTEL_SERVICE_NAME, upstream base image.
- verified: go build ./... (default + -tags ee) + all 20 nested modules green.
2026-07-05 13:08:55 -07:00

234 lines
6.5 KiB
Go

package client
import (
"context"
"encoding/json"
"fmt"
"net/http"
"time"
"github.com/hanzo-fi/payments/pkg/domain/metrics"
)
type WebhookEventType string
const (
// User Deleted indicates that a specific user has been deleted.
WebhookEventTypeUserDeleted WebhookEventType = "USER_DELETED"
// Connection Synced indicates that a specific connection of a user has been
// synced. It's the first webhook that is received when a user connects to
// his bank.
WebhookEventTypeConnectionSynced WebhookEventType = "CONNECTION_SYNCED"
// Connection Deleted indicates that a specific connection of a user has been
// deleted. It's the last webhook that is received when a user disconnects
// from his bank.
WebhookEventTypeConnectionDeleted WebhookEventType = "CONNECTION_DELETED"
// Accounts Fetched returns only the list of accounts that were fetched.
WebhookEventTypeAccountsFetched WebhookEventType = "ACCOUNTS_FETCHED"
// Accounts Synced returns the list of transactions that were fetched from a specific accounts
WebhookEventTypeAccountSynced WebhookEventType = "ACCOUNT_SYNCED"
)
type CreateWebhookAuthRequest struct {
Type string `json:"type"`
Name string `json:"name"`
}
type CreateWebhookAuthResponse struct {
ID int `json:"id"`
Type string `json:"type"`
Name string `json:"name"`
Config struct {
SecretKey string `json:"secret_key"`
} `json:"config"`
}
func (c *client) CreateWebhookAuth(ctx context.Context, name string) (string, error) {
ctx = context.WithValue(ctx, metrics.MetricOperationContextKey, "create_webhook_auth")
endpoint := fmt.Sprintf("%s/webhooks/auth", c.endpoint)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, endpoint, http.NoBody)
if err != nil {
return "", err
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", fmt.Sprintf("Bearer %s", c.configurationToken))
query := req.URL.Query()
query.Add("type", "hmac_signature")
// Connector ID is not accepted by the API, it returns a 500....
// fortunately name is unique also
query.Add("name", name)
req.URL.RawQuery = query.Encode()
var resp CreateWebhookAuthResponse
_, err = c.httpClient.Do(ctx, req, &resp, nil)
if err != nil {
return "", err
}
return resp.Config.SecretKey, nil
}
type webhookAuthResponse struct {
AuthProviders []WebhookAuth `json:"authproviders"`
}
type WebhookAuth struct {
ID int `json:"id"`
Type string `json:"type"`
Name string `json:"name"`
}
// There is no api documentation for these webhook auth endpoints, and I didn't
// find anything to filter them by name. So for now, we have no choice but to
// list them all and filter them by name by hand after that.
// After creating a ticket, they decided to not add the filter by name and
// closed the ticket.
func (c *client) ListWebhookAuths(ctx context.Context) ([]WebhookAuth, error) {
ctx = context.WithValue(ctx, metrics.MetricOperationContextKey, "list_webhook_auths")
endpoint := fmt.Sprintf("%s/webhooks/auth", c.endpoint)
req, err := http.NewRequestWithContext(ctx, http.MethodGet, endpoint, http.NoBody)
if err != nil {
return nil, err
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", fmt.Sprintf("Bearer %s", c.configurationToken))
query := req.URL.Query()
query.Add("limit", "1000")
req.URL.RawQuery = query.Encode()
var resp webhookAuthResponse
_, err = c.httpClient.Do(ctx, req, &resp, nil)
if err != nil {
return nil, err
}
return resp.AuthProviders, nil
}
func (c *client) DeleteWebhookAuth(ctx context.Context, id int) error {
ctx = context.WithValue(ctx, metrics.MetricOperationContextKey, "delete_webhook_auth")
endpoint := fmt.Sprintf("%s/webhooks/auth/%d", c.endpoint, id)
req, err := http.NewRequestWithContext(ctx, http.MethodDelete, endpoint, http.NoBody)
if err != nil {
return err
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", fmt.Sprintf("Bearer %s", c.configurationToken))
_, err = c.httpClient.Do(ctx, req, nil, nil)
if err != nil {
return err
}
return nil
}
type User struct {
ID int `json:"id"`
}
type Connection struct {
ID int `json:"id"`
Accounts []BankAccount `json:"accounts"`
}
type AccountFetchedWebhook struct {
User User `json:"user"`
Connection Connection `json:"connection"`
}
type ConnectionDeletedWebhook struct {
ConnectionID int `json:"id"`
}
type UserDeletedWebhook struct {
UserID int `json:"id"`
}
type ConnectionSyncedUser struct {
ID int `json:"id"`
}
type ConnectionSyncedConnection struct {
ID int `json:"id"`
State string `json:"state"`
ErrorMessage string `json:"error_message"`
LastUpdate time.Time `json:"last_update,omitempty"`
Active bool `json:"active"`
Accounts []BankAccount `json:"accounts"`
}
func (c ConnectionSyncedConnection) MarshalJSON() ([]byte, error) {
var lastUpdate string
if !c.LastUpdate.IsZero() {
var err error
lastUpdate, err = ConvertUTCToPowensTime(c.LastUpdate, time.DateTime)
if err != nil {
return nil, err
}
}
return json.Marshal(struct {
ID int `json:"id"`
State string `json:"state"`
ErrorMessage string `json:"error_message"`
LastUpdate string `json:"last_update,omitempty"`
Active bool `json:"active"`
Accounts []BankAccount `json:"accounts"`
}{
ID: c.ID,
State: c.State,
ErrorMessage: c.ErrorMessage,
LastUpdate: lastUpdate,
Active: c.Active,
Accounts: c.Accounts,
})
}
func (c *ConnectionSyncedConnection) UnmarshalJSON(data []byte) error {
type connectionSyncedConnection struct {
ID int `json:"id"`
State string `json:"state"`
ErrorMessage string `json:"error_message"`
LastUpdate string `json:"last_update,omitempty"`
Active bool `json:"active"`
Accounts []BankAccount `json:"accounts"`
}
var aux connectionSyncedConnection
if err := json.Unmarshal(data, &aux); err != nil {
return err
}
lastUpdate := time.Time{}
var err error
if aux.LastUpdate != "" {
lastUpdate, err = ConvertPowensTimeToUTC(aux.LastUpdate, time.DateTime)
if err != nil {
return err
}
}
*c = ConnectionSyncedConnection{
ID: aux.ID,
State: aux.State,
ErrorMessage: aux.ErrorMessage,
LastUpdate: lastUpdate,
Active: aux.Active,
Accounts: aux.Accounts,
}
return nil
}
type ConnectionSyncedWebhook struct {
User ConnectionSyncedUser `json:"user"`
Connection ConnectionSyncedConnection `json:"connection"`
}