Webhooks.V1

Overview

Available Operations

activateConfig - Activate one config
changeConfigSecret - Change the signing secret of a config
deactivateConfig - Deactivate one config
deleteConfig - Delete one config
getManyConfigs - Get many configs
insertConfig - Insert a new config
testConfig - Test one config
updateConfig - Update one config

activateConfig

Activate a webhooks config by ID, to start receiving webhooks to its endpoint.

Example Usage

package hello.world;

import com.formance.formance_sdk.SDK;
import com.formance.formance_sdk.models.errors.WebhooksErrorResponse;
import com.formance.formance_sdk.models.operations.ActivateConfigRequest;
import com.formance.formance_sdk.models.operations.ActivateConfigResponse;
import com.formance.formance_sdk.models.shared.Security;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws WebhooksErrorResponse, Exception {

        SDK sdk = SDK.builder()
                .security(Security.builder()
                    .clientID(System.getenv().getOrDefault("CLIENT_ID", ""))
                    .clientSecret(System.getenv().getOrDefault("CLIENT_SECRET", ""))
                    .build())
            .build();

        ActivateConfigRequest req = ActivateConfigRequest.builder()
                .id("4997257d-dfb6-445b-929c-cbe2ab182818")
                .build();

        ActivateConfigResponse res = sdk.webhooks().v1().activateConfig()
                .request(req)
                .call();

        if (res.configResponse().isPresent()) {
            System.out.println(res.configResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	ActivateConfigRequest	✔️	The request object to use for the request.

Response

ActivateConfigResponse

Errors

Error Type	Status Code	Content Type
models/errors/WebhooksErrorResponse	default	application/json
models/errors/SDKError	4XX, 5XX	/

changeConfigSecret

Change the signing secret of the endpoint of a webhooks config.

If not passed or empty, a secret is automatically generated. The format is a random string of bytes of size 24, base64 encoded. (larger size after encoding)

Example Usage

package hello.world;

import com.formance.formance_sdk.SDK;
import com.formance.formance_sdk.models.errors.WebhooksErrorResponse;
import com.formance.formance_sdk.models.operations.ChangeConfigSecretRequest;
import com.formance.formance_sdk.models.operations.ChangeConfigSecretResponse;
import com.formance.formance_sdk.models.shared.ConfigChangeSecret;
import com.formance.formance_sdk.models.shared.Security;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws WebhooksErrorResponse, Exception {

        SDK sdk = SDK.builder()
                .security(Security.builder()
                    .clientID(System.getenv().getOrDefault("CLIENT_ID", ""))
                    .clientSecret(System.getenv().getOrDefault("CLIENT_SECRET", ""))
                    .build())
            .build();

        ChangeConfigSecretRequest req = ChangeConfigSecretRequest.builder()
                .id("4997257d-dfb6-445b-929c-cbe2ab182818")
                .configChangeSecret(ConfigChangeSecret.builder()
                    .secret("V0bivxRWveaoz08afqjU6Ko/jwO0Cb+3")
                    .build())
                .build();

        ChangeConfigSecretResponse res = sdk.webhooks().v1().changeConfigSecret()
                .request(req)
                .call();

        if (res.configResponse().isPresent()) {
            System.out.println(res.configResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	ChangeConfigSecretRequest	✔️	The request object to use for the request.

Response

ChangeConfigSecretResponse

Errors

Error Type	Status Code	Content Type
models/errors/WebhooksErrorResponse	default	application/json
models/errors/SDKError	4XX, 5XX	/

deactivateConfig

Deactivate a webhooks config by ID, to stop receiving webhooks to its endpoint.

Example Usage

package hello.world;

import com.formance.formance_sdk.SDK;
import com.formance.formance_sdk.models.errors.WebhooksErrorResponse;
import com.formance.formance_sdk.models.operations.DeactivateConfigRequest;
import com.formance.formance_sdk.models.operations.DeactivateConfigResponse;
import com.formance.formance_sdk.models.shared.Security;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws WebhooksErrorResponse, Exception {

        SDK sdk = SDK.builder()
                .security(Security.builder()
                    .clientID(System.getenv().getOrDefault("CLIENT_ID", ""))
                    .clientSecret(System.getenv().getOrDefault("CLIENT_SECRET", ""))
                    .build())
            .build();

        DeactivateConfigRequest req = DeactivateConfigRequest.builder()
                .id("4997257d-dfb6-445b-929c-cbe2ab182818")
                .build();

        DeactivateConfigResponse res = sdk.webhooks().v1().deactivateConfig()
                .request(req)
                .call();

        if (res.configResponse().isPresent()) {
            System.out.println(res.configResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	DeactivateConfigRequest	✔️	The request object to use for the request.

Response

DeactivateConfigResponse

Errors

Error Type	Status Code	Content Type
models/errors/WebhooksErrorResponse	default	application/json
models/errors/SDKError	4XX, 5XX	/

deleteConfig

Delete a webhooks config by ID.

Example Usage

package hello.world;

import com.formance.formance_sdk.SDK;
import com.formance.formance_sdk.models.errors.WebhooksErrorResponse;
import com.formance.formance_sdk.models.operations.DeleteConfigRequest;
import com.formance.formance_sdk.models.operations.DeleteConfigResponse;
import com.formance.formance_sdk.models.shared.Security;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws WebhooksErrorResponse, Exception {

        SDK sdk = SDK.builder()
                .security(Security.builder()
                    .clientID(System.getenv().getOrDefault("CLIENT_ID", ""))
                    .clientSecret(System.getenv().getOrDefault("CLIENT_SECRET", ""))
                    .build())
            .build();

        DeleteConfigRequest req = DeleteConfigRequest.builder()
                .id("4997257d-dfb6-445b-929c-cbe2ab182818")
                .build();

        DeleteConfigResponse res = sdk.webhooks().v1().deleteConfig()
                .request(req)
                .call();

        // handle response
    }
}

Parameters

Parameter	Type	Required	Description
`request`	DeleteConfigRequest	✔️	The request object to use for the request.

Response

DeleteConfigResponse

Errors

Error Type	Status Code	Content Type
models/errors/WebhooksErrorResponse	default	application/json
models/errors/SDKError	4XX, 5XX	/

getManyConfigs

Sorted by updated date descending

Example Usage

package hello.world;

import com.formance.formance_sdk.SDK;
import com.formance.formance_sdk.models.errors.WebhooksErrorResponse;
import com.formance.formance_sdk.models.operations.GetManyConfigsRequest;
import com.formance.formance_sdk.models.operations.GetManyConfigsResponse;
import com.formance.formance_sdk.models.shared.Security;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws WebhooksErrorResponse, Exception {

        SDK sdk = SDK.builder()
                .security(Security.builder()
                    .clientID(System.getenv().getOrDefault("CLIENT_ID", ""))
                    .clientSecret(System.getenv().getOrDefault("CLIENT_SECRET", ""))
                    .build())
            .build();

        GetManyConfigsRequest req = GetManyConfigsRequest.builder()
                .endpoint("https://example.com")
                .id("4997257d-dfb6-445b-929c-cbe2ab182818")
                .build();

        GetManyConfigsResponse res = sdk.webhooks().v1().getManyConfigs()
                .request(req)
                .call();

        if (res.configsResponse().isPresent()) {
            System.out.println(res.configsResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	GetManyConfigsRequest	✔️	The request object to use for the request.

Response

GetManyConfigsResponse

Errors

Error Type	Status Code	Content Type
models/errors/WebhooksErrorResponse	default	application/json
models/errors/SDKError	4XX, 5XX	/

insertConfig

Insert a new webhooks config.

The endpoint should be a valid https URL and be unique.

The secret is the endpoint's verification secret. If not passed or empty, a secret is automatically generated. The format is a random string of bytes of size 24, base64 encoded. (larger size after encoding)

All eventTypes are converted to lower-case when inserted.

Example Usage

package hello.world;

import com.formance.formance_sdk.SDK;
import com.formance.formance_sdk.models.errors.WebhooksErrorResponse;
import com.formance.formance_sdk.models.operations.InsertConfigResponse;
import com.formance.formance_sdk.models.shared.ConfigUser;
import com.formance.formance_sdk.models.shared.Security;
import java.lang.Exception;
import java.util.List;

public class Application {

    public static void main(String[] args) throws WebhooksErrorResponse, Exception {

        SDK sdk = SDK.builder()
                .security(Security.builder()
                    .clientID(System.getenv().getOrDefault("CLIENT_ID", ""))
                    .clientSecret(System.getenv().getOrDefault("CLIENT_SECRET", ""))
                    .build())
            .build();

        ConfigUser req = ConfigUser.builder()
                .endpoint("https://example.com")
                .eventTypes(List.of(
                    "TYPE1",
                    "TYPE2"))
                .name("customer_payment")
                .secret("V0bivxRWveaoz08afqjU6Ko/jwO0Cb+3")
                .build();

        InsertConfigResponse res = sdk.webhooks().v1().insertConfig()
                .request(req)
                .call();

        if (res.configResponse().isPresent()) {
            System.out.println(res.configResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	ConfigUser	✔️	The request object to use for the request.

Response

InsertConfigResponse

Errors

Error Type	Status Code	Content Type
models/errors/WebhooksErrorResponse	default	application/json
models/errors/SDKError	4XX, 5XX	/

testConfig

Test a config by sending a webhook to its endpoint.

Example Usage

package hello.world;

import com.formance.formance_sdk.SDK;
import com.formance.formance_sdk.models.errors.WebhooksErrorResponse;
import com.formance.formance_sdk.models.operations.TestConfigRequest;
import com.formance.formance_sdk.models.operations.TestConfigResponse;
import com.formance.formance_sdk.models.shared.Security;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws WebhooksErrorResponse, Exception {

        SDK sdk = SDK.builder()
                .security(Security.builder()
                    .clientID(System.getenv().getOrDefault("CLIENT_ID", ""))
                    .clientSecret(System.getenv().getOrDefault("CLIENT_SECRET", ""))
                    .build())
            .build();

        TestConfigRequest req = TestConfigRequest.builder()
                .id("4997257d-dfb6-445b-929c-cbe2ab182818")
                .build();

        TestConfigResponse res = sdk.webhooks().v1().testConfig()
                .request(req)
                .call();

        if (res.attemptResponse().isPresent()) {
            System.out.println(res.attemptResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	TestConfigRequest	✔️	The request object to use for the request.

Response

TestConfigResponse

Errors

Error Type	Status Code	Content Type
models/errors/WebhooksErrorResponse	default	application/json
models/errors/SDKError	4XX, 5XX	/

updateConfig

Update a webhooks config by ID.

Example Usage

package hello.world;

import com.formance.formance_sdk.SDK;
import com.formance.formance_sdk.models.errors.WebhooksErrorResponse;
import com.formance.formance_sdk.models.operations.UpdateConfigRequest;
import com.formance.formance_sdk.models.operations.UpdateConfigResponse;
import com.formance.formance_sdk.models.shared.ConfigUser;
import com.formance.formance_sdk.models.shared.Security;
import java.lang.Exception;
import java.util.List;

public class Application {

    public static void main(String[] args) throws WebhooksErrorResponse, Exception {

        SDK sdk = SDK.builder()
                .security(Security.builder()
                    .clientID(System.getenv().getOrDefault("CLIENT_ID", ""))
                    .clientSecret(System.getenv().getOrDefault("CLIENT_SECRET", ""))
                    .build())
            .build();

        UpdateConfigRequest req = UpdateConfigRequest.builder()
                .configUser(ConfigUser.builder()
                    .endpoint("https://example.com")
                    .eventTypes(List.of(
                        "TYPE1",
                        "TYPE2"))
                    .name("customer_payment")
                    .secret("V0bivxRWveaoz08afqjU6Ko/jwO0Cb+3")
                    .build())
                .id("4997257d-dfb6-445b-929c-cbe2ab182818")
                .build();

        UpdateConfigResponse res = sdk.webhooks().v1().updateConfig()
                .request(req)
                .call();

        // handle response
    }
}

Parameters

Parameter	Type	Required	Description
`request`	UpdateConfigRequest	✔️	The request object to use for the request.

Response

UpdateConfigResponse

Errors

Error Type	Status Code	Content Type
models/errors/WebhooksErrorResponse	default	application/json
models/errors/SDKError	4XX, 5XX	/

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

Webhooks.V1

Overview

Available Operations

activateConfig

Example Usage

Parameters

Response

Errors

changeConfigSecret

Example Usage

Parameters

Response

Errors

deactivateConfig

Example Usage

Parameters

Response

Errors

deleteConfig

Example Usage

Parameters

Response

Errors

getManyConfigs

Example Usage

Parameters

Response

Errors

insertConfig

Example Usage

Parameters

Response

Errors

testConfig

Example Usage

Parameters

Response

Errors

updateConfig

Example Usage

Parameters

Response

Errors