README

The GOV.UK Pay REST API. Read our documentation for more details.

This PHP package is automatically generated by the Swagger Codegen project:

• API version: 1.0.3
• Build package: io.swagger.codegen.v3.generators.php.PhpClientCodegen

Requirements

PHP 5.5 and later

Installation & Usage

Composer

To install the bindings via Composer, add the following to composer.json:

{
  "repositories": [
    {
      "type": "git",
      "url": "https://github.com/git_user_id/git_repo_id.git"
    }
  ],
  "require": {
    "git_user_id/git_repo_id": "*@dev"
  }
}

Then run composer install

Manual Installation

Download the files and include autoload.php:

    require_once('/path/to/SwaggerClient-php/vendor/autoload.php');

Tests

To run the unit tests:

composer install
./vendor/bin/phpunit

Getting Started

Please follow the installation procedure and then run the following:

<?php
require_once(__DIR__ . '/vendor/autoload.php');


$apiInstance = new Swagger\Client\Api\AgreementsApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client(),
    $config
);
$agreement_id = "agreement_id_example"; // string | The `agreement_id` of the agreement you are cancelling

try {
    $apiInstance->cancelAnAgreement($agreement_id);
} catch (Exception $e) {
    echo 'Exception when calling AgreementsApi->cancelAnAgreement: ', $e->getMessage(), PHP_EOL;
}


$apiInstance = new Swagger\Client\Api\AgreementsApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client(),
    $config
);
$body = new \Swagger\Client\Model\CreateAgreementRequest(); // \Swagger\Client\Model\CreateAgreementRequest | requestPayload

try {
    $result = $apiInstance->createAnAgreement($body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling AgreementsApi->createAnAgreement: ', $e->getMessage(), PHP_EOL;
}


$apiInstance = new Swagger\Client\Api\AgreementsApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client(),
    $config
);
$agreement_id = "agreement_id_example"; // string | Returns the agreement with the matching `agreement_id`. GOV.UK Pay generated an `agreement_id` when you created the agreement.

try {
    $result = $apiInstance->getAnAgreement($agreement_id);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling AgreementsApi->getAnAgreement: ', $e->getMessage(), PHP_EOL;
}


$apiInstance = new Swagger\Client\Api\AgreementsApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client(),
    $config
);
$reference = "reference_example"; // string | Returns agreements with a `reference` that exactly matches the value you sent. This parameter is not case sensitive. A `reference` was associated with the agreement when that agreement was created.
$status = "status_example"; // string | Returns agreements in a matching `status`. `status` reflects where an agreement is in its lifecycle. You can [read more about the meanings of the different agreement status values](https://docs.payments.service.gov.uk/recurring_payments/#understanding-agreement-status).
$page = "page_example"; // string | Returns a specific page of results. Defaults to `1`. You can [read about search pagination](https://docs.payments.service.gov.uk/api_reference/#pagination)
$display_size = "display_size_example"; // string | The number of agreements returned per results page. Defaults to `500`. Maximum value is `500`. You can [read about search pagination](https://docs.payments.service.gov.uk/api_reference/#pagination)

try {
    $result = $apiInstance->searchAgreements($reference, $status, $page, $display_size);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling AgreementsApi->searchAgreements: ', $e->getMessage(), PHP_EOL;
}
?>

Documentation for API Endpoints

All URIs are relative to https://publicapi.payments.service.gov.uk

Documentation For Models

• Address
• Agreement
• AgreementSearchResults
• AuthorisationRequest
• AuthorisationSummary
• CardDetails
• CreateAgreementRequest
• CreateCardPaymentRequest
• CreatePaymentResult
• DisputeDetailForSearch
• DisputeLinksForSearch
• DisputesSearchResults
• EmbeddedRefunds
• ErrorResponse
• ExternalMetadata
• Link
• PaymentDetailForSearch
• PaymentEvent
• PaymentEventLink
• PaymentEvents
• PaymentInstrument
• PaymentLinks
• PaymentLinksForEvents
• PaymentLinksForSearch
• PaymentRefundRequest
• PaymentSearchResults
• PaymentSettlementSummary
• PaymentState
• PaymentWithAllLinks
• PostLink
• PrefilledCardholderDetails
• Refund
• RefundDetailForSearch
• RefundForSearchResult
• RefundLinksForSearch
• RefundSearchResults
• RefundSettlementSummary
• RefundSummary
• RefundsResponse
• RequestError
• SearchNavigationLinks
• SettlementSummary
• ThreeDSecure

Documentation For Authorization

BearerAuth

• Type: HTTP bearer authentication

Author