los / mundiapi
Mundipagg API
Requires
- php: >=5.4.0
- ext-curl: *
- ext-json: *
- ext-mbstring: *
- apimatic/jsonmapper: ~1.2.0
- mashape/unirest-php: ~3.0.1
Requires (Dev)
- phpunit/phpunit: 4.8.*
- squizlabs/php_codesniffer: ^2.7
This package is auto-updated.
Last update: 2025-02-26 04:39:01 UTC
README
Mundipagg API
How to Build
The generated code has dependencies over external libraries like UniRest. These dependencies are defined in the composer.json
file that comes with the SDK.
To resolve these dependencies, we use the Composer package manager which requires PHP greater than 5.3.2 installed in your system.
Visit https://getcomposer.org/download/ to download the installer file for Composer and run it in your system.
Open command prompt and type composer --version
. This should display the current version of the Composer installed if the installation was successful.
- Using command line, navigate to the directory containing the generated files (including
composer.json
) for the SDK. - Run the command
composer install
. This should install all the required dependencies and create thevendor
directory in your project directory.
[For Windows Users Only] Configuring CURL Certificate Path in php.ini
CURL used to include a list of accepted CAs, but no longer bundles ANY CA certs. So by default it will reject all SSL certificates as unverifiable. You will have to get your CA's cert and point curl at it. The steps are as follows:
- Download the certificate bundle (.pem file) from https://curl.haxx.se/docs/caextract.html on to your system.
- Add curl.cainfo = "PATH_TO/cacert.pem" to your php.ini file located in your php installation. “PATH_TO” must be an absolute path containing the .pem file.
[curl] ; A default value for the CURLOPT_CAINFO option. This is required to be an ; absolute path. ;curl.cainfo =
How to Use
The following section explains how to use the MundiAPI library in a new project.
1. Open Project in an IDE
Open an IDE for PHP like PhpStorm. The basic workflow presented here is also applicable if you prefer using a different editor or IDE.
Click on Open
in PhpStorm to browse to your generated SDK directory and then click OK
.
2. Add a new Test Project
Create a new directory by right clicking on the solution name as shown below:
Name the directory as "test"
Add a PHP file to this project
Name it "testSDK"
Depending on your project setup, you might need to include composer's autoloader in your PHP code to enable auto loading of classes.
require_once "../vendor/autoload.php";
It is important that the path inside require_once correctly points to the file autoload.php
inside the vendor directory created during dependency installations.
After this you can add code to initialize the client library and acquire the instance of a Controller class. Sample code to initialize the client library and using controller methods is given in the subsequent sections.
3. Run the Test Project
To run your project you must set the Interpreter for your project. Interpreter is the PHP engine installed on your computer.
Open Settings
from File
menu.
Select PHP
from within Languages & Frameworks
Browse for Interpreters near the Interpreter
option and choose your interpreter.
Once the interpreter is selected, click OK
To run your project, right click on your PHP file inside your Test project and click on Run
How to Test
Unit tests in this SDK can be run using PHPUnit.
- First install the dependencies using composer including the
require-dev
dependencies. - Run
vendor\bin\phpunit --verbose
from commandline to execute tests. If you have installed PHPUnit globally, run tests usingphpunit --verbose
instead.
You can change the PHPUnit test configuration in the phpunit.xml
file.
Initialization
Authentication
In order to setup authentication and initialization of the API client, you need the following information.
Parameter | Description |
---|---|
basicAuthUserName | The username to use with basic authentication |
basicAuthPassword | The password to use with basic authentication |
API client can be initialized as following.
$basicAuthUserName = 'basicAuthUserName'; // The username to use with basic authentication $basicAuthPassword = 'basicAuthPassword'; // The password to use with basic authentication $client = new MundiAPILib\MundiAPIClient($basicAuthUserName, $basicAuthPassword);
Class Reference
List of Controllers
- ChargesController
- CustomersController
- SubscriptionsController
- PlansController
- InvoicesController
- OrdersController
ChargesController
Get singleton instance
The singleton instance of the ChargesController
class can be accessed from the API Client.
$charges = $client->getCharges();
getCharge
Get a charge from its id
function getCharge($chargeId)
Parameters
Parameter | Tags | Description |
---|---|---|
chargeId | Required |
Charge id |
Example Usage
$chargeId = 'ch_wbnd47nCJJFKVZQy'; $result = $charges->getCharge($chargeId);
retryCharge
Retries a charge
function retryCharge($chargeId)
Parameters
Parameter | Tags | Description |
---|---|---|
chargeId | Required |
Charge id |
Example Usage
$chargeId = 'charge_id'; $result = $charges->retryCharge($chargeId);
getCharges
Lists all charges
function getCharges()
Example Usage
$result = $charges->getCharges();
createCharge
Creates a new charge
function createCharge($request)
Parameters
Parameter | Tags | Description |
---|---|---|
request | Required |
Request for creating a charge |
Example Usage
$request = new CreateChargeRequest(); $result = $charges->createCharge($request);
updateChargeCard
Updates the card from a charge
function updateChargeCard( $chargeId, $request)
Parameters
Parameter | Tags | Description |
---|---|---|
chargeId | Required |
Charge id |
request | Required |
Request for updating a charge's card |
Example Usage
$chargeId = 'charge_id'; $request = new UpdateChargeCardRequest(); $result = $charges->updateChargeCard($chargeId, $request);
updateChargePaymentMethod
Updates a charge's payment method
function updateChargePaymentMethod( $chargeId, $request)
Parameters
Parameter | Tags | Description |
---|---|---|
chargeId | Required |
Charge id |
request | Required |
Request for updating the payment method from a charge |
Example Usage
$chargeId = 'charge_id'; $request = new UpdateChargePaymentMethodRequest(); $result = $charges->updateChargePaymentMethod($chargeId, $request);
cancelCharge
Cancel a charge
function cancelCharge( $chargeId, $request = null)
Parameters
Parameter | Tags | Description |
---|---|---|
chargeId | Required |
Charge id |
request | Optional |
Request for cancelling a charge |
Example Usage
$chargeId = 'charge_id'; $request = new CreateCancelChargeRequest(); $result = $charges->cancelCharge($chargeId, $request);
captureCharge
Captures a charge
function captureCharge( $chargeId, $request = null)
Parameters
Parameter | Tags | Description |
---|---|---|
chargeId | Required |
Charge id |
request | Optional |
Request for capturing a charge |
Example Usage
$chargeId = 'charge_id'; $request = new CreateCaptureChargeRequest(); $result = $charges->captureCharge($chargeId, $request);
CustomersController
Get singleton instance
The singleton instance of the CustomersController
class can be accessed from the API Client.
$customers = $client->getCustomers();
getAddresses
Gets all adressess from a customer
function getAddresses($customerId)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer id |
Example Usage
$customerId = 'customer_id'; $result = $customers->getAddresses($customerId);
getCards
Get all cards from a customer
function getCards($customerId)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer Id |
Example Usage
$customerId = 'customer_id'; $result = $customers->getCards($customerId);
getCustomers
Get all Customers
function getCustomers()
Example Usage
$result = $customers->getCustomers();
createCustomer
Creates a new customer
function createCustomer($request)
Parameters
Parameter | Tags | Description |
---|---|---|
request | Required |
Request for creating a customer |
Example Usage
$request = new CreateCustomerRequest(); $result = $customers->createCustomer($request);
getCustomer
Get a customer
function getCustomer($customerId)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer Id |
Example Usage
$customerId = 'customer_id'; $result = $customers->getCustomer($customerId);
updateAddress
Updates an address
function updateAddress( $customerId, $addressId, $request)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer Id |
addressId | Required |
Address Id |
request | Required |
Request for updating an address |
Example Usage
$customerId = 'customer_id'; $addressId = 'address_id'; $request = new UpdateAddressRequest(); $result = $customers->updateAddress($customerId, $addressId, $request);
updateCard
Updates a card
function updateCard( $customerId, $cardId, $request)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer Id |
cardId | Required |
Card id |
request | Required |
Request for updating a card |
Example Usage
$customerId = 'customer_id'; $cardId = 'card_id'; $request = new UpdateCardRequest(); $result = $customers->updateCard($customerId, $cardId, $request);
getAddress
Get a customer's address
function getAddress( $customerId, $addressId)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer id |
addressId | Required |
Address Id |
Example Usage
$customerId = 'customer_id'; $addressId = 'address_id'; $result = $customers->getAddress($customerId, $addressId);
deleteAddress
Delete a Customer's address
function deleteAddress( $customerId, $addressId)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer Id |
addressId | Required |
Address Id |
Example Usage
$customerId = 'customer_id'; $addressId = 'address_id'; $result = $customers->deleteAddress($customerId, $addressId);
deleteCard
Delete a customer's card
function deleteCard( $customerId, $cardId)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer Id |
cardId | Required |
Card Id |
Example Usage
$customerId = 'customer_id'; $cardId = 'card_id'; $result = $customers->deleteCard($customerId, $cardId);
createAddress
Creates a new address for a customer
function createAddress( $customerId, $request)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer Id |
request | Required |
Request for creating an address |
Example Usage
$customerId = 'customer_id'; $request = new CreateAddressRequest(); $result = $customers->createAddress($customerId, $request);
getCard
Get a customer's card
function getCard( $customerId, $cardId)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer id |
cardId | Required |
Card id |
Example Usage
$customerId = 'customer_id'; $cardId = 'card_id'; $result = $customers->getCard($customerId, $cardId);
createCard
Creates a new card for a customer
function createCard( $customerId, $request)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer id |
request | Required |
Request for creating a card |
Example Usage
$customerId = 'customer_id'; $request = new CreateCardRequest(); $result = $customers->createCard($customerId, $request);
updateCustomer
Updates a customer
function updateCustomer( $customerId, $request)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer id |
request | Required |
Request for updating a customer |
Example Usage
$customerId = 'customer_id'; $request = new UpdateCustomerRequest(); $result = $customers->updateCustomer($customerId, $request);
deleteAccessTokens
Delete a Customer's access tokens
function deleteAccessTokens($customerId)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer Id |
Example Usage
$customerId = 'customer_id'; $result = $customers->deleteAccessTokens($customerId);
getAccessTokens
Get all access tokens from a customer
function getAccessTokens($customerId)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer Id |
Example Usage
$customerId = 'customer_id'; $result = $customers->getAccessTokens($customerId);
deleteAccessToken
Delete a customer's access token
function deleteAccessToken( $customerId, $tokenId)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer Id |
tokenId | Required |
Token Id |
Example Usage
$customerId = 'customer_id'; $tokenId = 'token_id'; $result = $customers->deleteAccessToken($customerId, $tokenId);
createAccessToken
Creates a access token for a customer
function createAccessToken( $customerId, $request)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer Id |
request | Required |
Request for creating a access token |
Example Usage
$customerId = 'customer_id'; $request = new CreateAccessTokenRequest(); $result = $customers->createAccessToken($customerId, $request);
getAccessToken
Get a Customer's access token
function getAccessToken( $customerId, $tokenId)
Parameters
Parameter | Tags | Description |
---|---|---|
customerId | Required |
Customer Id |
tokenId | Required |
Token Id |
Example Usage
$customerId = 'customer_id'; $tokenId = 'token_id'; $result = $customers->getAccessToken($customerId, $tokenId);
SubscriptionsController
Get singleton instance
The singleton instance of the SubscriptionsController
class can be accessed from the API Client.
$subscriptions = $client->getSubscriptions();
updateSubscriptionBillingDate
Updates the billing date from a subscription
function updateSubscriptionBillingDate( $subscriptionId, $request)
Parameters
Parameter | Tags | Description |
---|---|---|
subscriptionId | Required |
The subscription id |
request | Required |
Request for updating the subscription billing date |
Example Usage
$subscriptionId = 'subscription_id'; $request = new UpdateSubscriptionBillingDateRequest(); $result = $subscriptions->updateSubscriptionBillingDate($subscriptionId, $request);
createUsage
Creates a usage
function createUsage( $subscriptionId, $itemId, $body)
Parameters
Parameter | Tags | Description |
---|---|---|
subscriptionId | Required |
Subscription Id |
itemId | Required |
Item id |
body | Required |
Request for creating a usage |
Example Usage
$subscriptionId = 'subscription_id'; $itemId = 'item_id'; $body = new CreateUsageRequest(); $result = $subscriptions->createUsage($subscriptionId, $itemId, $body);
updateSubscriptionItem
Updates a subscription item
function updateSubscriptionItem( $subscriptionId, $itemId, $body)
Parameters
Parameter | Tags | Description |
---|---|---|
subscriptionId | Required |
Subscription Id |
itemId | Required |
Item id |
body | Required |
Request for updating a subscription item |
Example Usage
$subscriptionId = 'subscription_id'; $itemId = 'item_id'; $body = new UpdateSubscriptionItemRequest(); $result = $subscriptions->updateSubscriptionItem($subscriptionId, $itemId, $body);
getSubscriptions
Gets all subscriptions
function getSubscriptions()
Example Usage
$result = $subscriptions->getSubscriptions();
updateSubscriptionCard
Updates the credit card from a subscription
function updateSubscriptionCard( $subscriptionId, $request)
Parameters
Parameter | Tags | Description |
---|---|---|
subscriptionId | Required |
Subscription id |
request | Required |
Request for updating a card |
Example Usage
$subscriptionId = 'subscription_id'; $request = new UpdateSubscriptionCardRequest(); $result = $subscriptions->updateSubscriptionCard($subscriptionId, $request);
createSubscription
Creates a new subscription
function createSubscription($body)
Parameters
Parameter | Tags | Description |
---|---|---|
body | Required |
Request for creating a subscription |
Example Usage
$body = new CreateSubscriptionRequest(); $result = $subscriptions->createSubscription($body);
createSubscriptionItem
Creates a new Subscription item
function createSubscriptionItem( $subscriptionId, $request)
Parameters
Parameter | Tags | Description |
---|---|---|
subscriptionId | Required |
Subscription id |
request | Required |
Request for creating a subscription item |
Example Usage
$subscriptionId = 'subscription_id'; $request = new CreateSubscriptionItemRequest(); $result = $subscriptions->createSubscriptionItem($subscriptionId, $request);
createDiscount
Creates a discount
function createDiscount( $subscriptionId, $request)
Parameters
Parameter | Tags | Description |
---|---|---|
subscriptionId | Required |
Subscription id |
request | Required |
Request for creating a discount |
Example Usage
$subscriptionId = 'subscription_id'; $request = new CreateDiscountRequest(); $result = $subscriptions->createDiscount($subscriptionId, $request);
getSubscription
Gets a subscription
function getSubscription($subscriptionId)
Parameters
Parameter | Tags | Description |
---|---|---|
subscriptionId | Required |
Subscription id |
Example Usage
$subscriptionId = 'subscription_id'; $result = $subscriptions->getSubscription($subscriptionId);
updateSubscriptionPaymentMethod
Updates the payment method from a subscription
function updateSubscriptionPaymentMethod( $subscriptionId, $request)
Parameters
Parameter | Tags | Description |
---|---|---|
subscriptionId | Required |
Subscription id |
request | Required |
Request for updating the paymentmethod from a subscription |
Example Usage
$subscriptionId = 'subscription_id'; $request = new UpdateSubscriptionPaymentMethodRequest(); $result = $subscriptions->updateSubscriptionPaymentMethod($subscriptionId, $request);
getUsages
Lists all usages from a subscription item
function getUsages( $subscriptionId, $itemId)
Parameters
Parameter | Tags | Description |
---|---|---|
subscriptionId | Required |
The subscription id |
itemId | Required |
The subscription item id |
Example Usage
$subscriptionId = 'subscription_id'; $itemId = 'item_id'; $result = $subscriptions->getUsages($subscriptionId, $itemId);
deleteUsage
Deletes a usage
function deleteUsage( $subscriptionId, $itemId, $usageId)
Parameters
Parameter | Tags | Description |
---|---|---|
subscriptionId | Required |
The subscription id |
itemId | Required |
The subscription item id |
usageId | Required |
The usage id |
Example Usage
$subscriptionId = 'subscription_id'; $itemId = 'item_id'; $usageId = 'usage_id'; $result = $subscriptions->deleteUsage($subscriptionId, $itemId, $usageId);
deleteDiscount
Deletes a discount
function deleteDiscount( $subscriptionId, $discountId)
Parameters
Parameter | Tags | Description |
---|---|---|
subscriptionId | Required |
Subscription id |
discountId | Required |
Discount Id |
Example Usage
$subscriptionId = 'subscription_id'; $discountId = 'discount_id'; $result = $subscriptions->deleteDiscount($subscriptionId, $discountId);
cancelSubscription
Cancels a subscription
function cancelSubscription( $subscriptionId, $request = null)
Parameters
Parameter | Tags | Description |
---|---|---|
subscriptionId | Required |
Subscription id |
request | Optional |
Request for cancelling a subscription |
Example Usage
$subscriptionId = 'subscription_id'; $request = new CreateCancelSubscriptionRequest(); $result = $subscriptions->cancelSubscription($subscriptionId, $request);
deleteSubscriptionItem
Deletes a subscription item
function deleteSubscriptionItem( $subscriptionId, $subscriptionItemId)
Parameters
Parameter | Tags | Description |
---|---|---|
subscriptionId | Required |
Subscription id |
subscriptionItemId | Required |
Subscription item id |
Example Usage
$subscriptionId = 'subscription_id'; $subscriptionItemId = 'subscription_item_id'; $result = $subscriptions->deleteSubscriptionItem($subscriptionId, $subscriptionItemId);
PlansController
Get singleton instance
The singleton instance of the PlansController
class can be accessed from the API Client.
$plans = $client->getPlans();
getPlanItems
Gets all items from a plan
function getPlanItems($planId)
Parameters
Parameter | Tags | Description |
---|---|---|
planId | Required |
Plan id |
Example Usage
$planId = 'plan_id'; $result = $plans->getPlanItems($planId);
updatePlanItem
Updates a plan item
function updatePlanItem( $planId, $planItemId, $body)
Parameters
Parameter | Tags | Description |
---|---|---|
planId | Required |
Plan id |
planItemId | Required |
Plan item id |
body | Required |
Request for updating the plan item |
Example Usage
$planId = 'plan_id'; $planItemId = 'plan_item_id'; $body = new UpdatePlanItemRequest(); $result = $plans->updatePlanItem($planId, $planItemId, $body);
getPlan
Gets a plan
function getPlan($planId)
Parameters
Parameter | Tags | Description |
---|---|---|
planId | Required |
Plan id |
Example Usage
$planId = 'plan_id'; $result = $plans->getPlan($planId);
createPlanItem
Adds a new item to a plan
function createPlanItem( $planId, $request)
Parameters
Parameter | Tags | Description |
---|---|---|
planId | Required |
Plan id |
request | Required |
Request for creating a plan item |
Example Usage
$planId = 'plan_id'; $request = new CreatePlanItemRequest(); $result = $plans->createPlanItem($planId, $request);
updatePlan
Updates a plan
function updatePlan( $planId, $request)
Parameters
Parameter | Tags | Description |
---|---|---|
planId | Required |
Plan id |
request | Required |
Request for updating a plan |
Example Usage
$planId = 'plan_id'; $request = new UpdatePlanRequest(); $result = $plans->updatePlan($planId, $request);
createPlan
Creates a new plan
function createPlan($body)
Parameters
Parameter | Tags | Description |
---|---|---|
body | Required |
Request for creating a plan |
Example Usage
$body = new CreatePlanRequest(); $result = $plans->createPlan($body);
getPlans
Gets all plans
function getPlans()
Example Usage
$result = $plans->getPlans();
deletePlan
Deletes a plan
function deletePlan($planId)
Parameters
Parameter | Tags | Description |
---|---|---|
planId | Required |
Plan id |
Example Usage
$planId = 'plan_id'; $result = $plans->deletePlan($planId);
getPlanItem
Gets a plan item
function getPlanItem( $planId, $planItemId)
Parameters
Parameter | Tags | Description |
---|---|---|
planId | Required |
Plan id |
planItemId | Required |
Plan item id |
Example Usage
$planId = 'plan_id'; $planItemId = 'plan_item_id'; $result = $plans->getPlanItem($planId, $planItemId);
deletePlanItem
Removes an item from a plan
function deletePlanItem( $planId, $planItemId)
Parameters
Parameter | Tags | Description |
---|---|---|
planId | Required |
Plan id |
planItemId | Required |
Plan item id |
Example Usage
$planId = 'plan_id'; $planItemId = 'plan_item_id'; $result = $plans->deletePlanItem($planId, $planItemId);
InvoicesController
Get singleton instance
The singleton instance of the InvoicesController
class can be accessed from the API Client.
$invoices = $client->getInvoices();
cancelInvoice
Cancels an invoice
function cancelInvoice($invoiceId)
Parameters
Parameter | Tags | Description |
---|---|---|
invoiceId | Required |
Invoice id |
Example Usage
$invoiceId = 'invoice_id'; $result = $invoices->cancelInvoice($invoiceId);
getLastInvoiceCharge
Gets the last charge from an invoice
function getLastInvoiceCharge($invoiceId)
Parameters
Parameter | Tags | Description |
---|---|---|
invoiceId | Required |
Invoice id |
Example Usage
$invoiceId = 'invoice_id'; $result = $invoices->getLastInvoiceCharge($invoiceId);
getInvoices
Gets all invoices
function getInvoices()
Example Usage
$result = $invoices->getInvoices();
getInvoice
Gets an invoice
function getInvoice($invoiceId)
Parameters
Parameter | Tags | Description |
---|---|---|
invoiceId | Required |
Invoice Id |
Example Usage
$invoiceId = 'invoice_id'; $result = $invoices->getInvoice($invoiceId);
OrdersController
Get singleton instance
The singleton instance of the OrdersController
class can be accessed from the API Client.
$orders = $client->getOrders();
getOrder
Gets an order
function getOrder($orderId)
Parameters
Parameter | Tags | Description |
---|---|---|
orderId | Required |
Order id |
Example Usage
$orderId = 'order_id'; $result = $orders->getOrder($orderId);
getOrders
Gets all orders
function getOrders()
Example Usage
$result = $orders->getOrders();
createOrder
Creates a new Order
function createOrder($body)
Parameters
Parameter | Tags | Description |
---|---|---|
body | Required |
Request for creating an order |
Example Usage
$body = new CreateOrderRequest(); $result = $orders->createOrder($body);