Skip to content

Latest commit

 

History

History
229 lines (173 loc) · 9.95 KB

README.md

File metadata and controls

229 lines (173 loc) · 9.95 KB

dodopayments PHP SDK 0.19.0

Welcome to the dodopayments SDK documentation. This guide will help you get started with integrating and using the dodopayments SDK in your project.

This SDK was generated by liblab

Versions

  • API version: 0.19.0
  • SDK version: 0.19.0

Table of Contents

Setup & Configuration

Supported Language Versions

This SDK is compatible with the following versions: PHP >= 8.0

Installation

To get started with the SDK, we recommend installing using composer:

composer require dodopayments/client

Authentication

Access Token Authentication

The dodopayments API uses an Access Token for authentication.

This token must be provided to authenticate your requests to the API.

Setting the Access Token

When you initialize the SDK, you can set the access token as follows:

new Client(accessToken: "YOUR_ACCESS_TOKEN");

If you need to set or update the access token after initializing the SDK, you can use:

sdk.setAccessToken("YOUR_ACCESS_TOKEN")

Environments

The SDK supports different environments for various stages of development and deployment.

Here are the available environments:

const Default = "https://live.dodopayments.com"
const LiveMode = "https://live.dodopayments.com"
const TestMode = "https://test.dodopayments.com"

Setting an Environment

To configure the SDK to use a specific environment, you can set the base URL as follows:

$sdk->setBaseUrl(Environment::live_mode);

Setting a Custom Timeout

You can set a custom timeout for the SDK's HTTP requests as follows:

$sdk = new Client(timeout: 1000);

Sample Usage

Below is a comprehensive example demonstrating how to authenticate and call a simple endpoint:

<?php

use Dodopayments\Client;

$sdk = new Client(accessToken: 'YOUR_TOKEN');

$response = $sdk->checkout->getSupportedCountriesProxy();

print_r($response);

Services

The SDK provides various services to interact with the API.

Below is a list of all available services with links to their detailed documentation:
Name
Checkout
Customers
Disputes
Invoices
LicenseKeys
Licenses
Payments
Payouts
Products
Refunds
Subscriptions
WebhookEvents
OutgoingWebhooks

Models

The SDK includes several models that represent the data structures used in API requests and responses. These models help in organizing and managing the data efficiently.

Below is a list of all available models with links to their detailed documentation:
Name Description
CountryCodeAlpha2 ISO country code alpha2 variant
GetCustomersListResponse
CreateCustomerRequest
CustomerResponse
PatchCustomerRequest
GetDisputesListResponse
DisputeStatus
DisputeStage
DisputeResponse
ListLicenseKeyInstancesResponse
LicenseKeyInstanceResponse
PatchLicenseKeyInstanceRequest
ListLicenseKeysResponse
LicenseKeyStatus
LicenseKeyResponse
PatchLicenseKeyRequest
ActivateLicenseKeyRequest
DeactivateLicenseKeyRequest
ValidateLicenseKeyRequest
ValidateLicenseKeyResponse
GetPaymentsListResponse
IntentStatus
CreateOneTimePaymentRequest
CreateOneTimePaymentResponse
PaymentResponse
GetPayoutsResponseList
GetProductsListResponse
CreateProductRequest
GetProductResponse
PatchProductRequest
UpdateProductImageResponse
GetRefundsListResponse
RefundStatus
CreateRefundRequest
RefundResponse
GetSubscriptionsListResponse
SubscriptionStatus
CreateSubscriptionRequest Request payload for creating a new subscription This struct represents the data required to create a new subscription in the system. It includes details about the product, quantity, customer information, and billing details.
CreateSubscriptionResponse
SubscriptionResponse Response struct representing subscription details
PatchSubscriptionRequest
ListWebhookEventsResponse
WebhookEventLogResponse
OutgoingWebhook
GetPaymentsListResponseItem
Currency
CustomerLimitedDetailsResponse
BillingAddress
CustomerRequest
OneTimeProductCartItem
AttachExistingCustomer
CreateNewCustomer
PayoutsResponse
PayoutStatus
GetProductsListResponseItem
Price
TaxCategory Represents the different categories of taxation applicable to various products and services.
Price_1
Price_2
Price_1Type
TimeInterval
Price_2Type
LicenseKeyDuration
OutgoingWebhookData
EventType Event types for Dodo events
OutgoingWebhookData_1
OutgoingWebhookData_2
OutgoingWebhookData_3
OutgoingWebhookData_4
OutgoingWebhookData_5
OutgoingWebhookData_1PayloadType
OutgoingWebhookData_2PayloadType
OutgoingWebhookData_3PayloadType
OutgoingWebhookData_4PayloadType
OutgoingWebhookData_5PayloadType

License

This SDK is licensed under the Apache-2.0 License.

See the LICENSE file for more details.