coreproc / paymaya-sdk

2.5.1 2025-07-25 02:37 UTC

Requires

• php: ^7.2|^8.0
• ext-json: *
• guzzlehttp/guzzle: ^6.0 || ^7.0

Requires (Dev)

• dms/phpunit-arraysubset-asserts: ^0.4.0
• mockery/mockery: ^1.3
• phpunit/phpunit: ^8.2
• symfony/var-dumper: ^4.3

MIT

• Chris Bautista

• coreproc
• paymaya-sdk

Published on Packagist.org on 2025-07-25 02:38 UTC

README

This is an unofficial SDK for PayMaya using PHP but offers improvements over the official PayMaya codebase.

Installation

You can install the package via composer:

composer require coreproc/paymaya-sdk

Usage

Read the documentation here: https://s3-ap-southeast-1.amazonaws.com/developers.paymaya.com.checkout/checkout.html

To get development API keys and credit cards, check the link here: https://developers.paymaya.com/blog/entry/api-test-merchants-and-test-cards

Initiate checkout of items

Here is an example of how to use this SDK with checkout. The example is based off the payload found in the documentation.

$payMayaApi = new \CoreProc\PayMaya\PayMayaApi('<SECRET_API_KEY>',
    '<PUBLIC_API_KEY>', \CoreProc\PayMaya\PayMayaApi::ENVIRONMENT_SANDBOX);

$checkout = new \CoreProc\PayMaya\Requests\Checkout();

$checkout->setTotalAmount(
    (new \CoreProc\PayMaya\Requests\TotalAmount())
        ->setCurrency('PHP')
        ->setValue(6304.90)
        ->setDetails(
            (new \CoreProc\PayMaya\Requests\AmountDetail())
                ->setDiscount(300.00)
                ->setServiceCharge(50.00)
                ->setShippingFee(200.00)
                ->setTax(691.60)
                ->setSubtotal(5763.30))
)->setBuyer(
    (new \CoreProc\PayMaya\Requests\Buyer())
        ->setFirstName('Juan')
        ->setMiddleName('dela')
        ->setLastName('Cruz')
        ->setContact(
            (new \CoreProc\PayMaya\Requests\Contact())
                ->setEmail('[e-mail]')
                ->setPhone('[phone]')
        )->setShippingAddress(
            (new \CoreProc\PayMaya\Requests\Address())
                ->setLine1('9F Robinsons Cybergate 3')
                ->setLine2('Pioneer Street')
                ->setCity('Mandaluyong City')
                ->setState('Metro Manila')
                ->setZipCode('12345')
                ->setCountryCode('PH')
        )->setBillingAddress(
            (new \CoreProc\PayMaya\Requests\Address())
                ->setLine1('9F Robinsons Cybergate 3')
                ->setLine2('Pioneer Street')
                ->setCity('Mandaluyong City')
                ->setState('Metro Manila')
                ->setZipCode('12345')
                ->setCountryCode('PH')
        )
        ->setIpAddress('125.60.148.241')
)->setItems([
    (new \CoreProc\PayMaya\Requests\Item())
        ->setName('Canvas Slip Ons')
        ->setCode('CVG-096732')
        ->setDescription('Shoes')
        ->setQuantity(3)
        ->setAmount(
            (new \CoreProc\PayMaya\Requests\ItemAmount())
                ->setValue(1621.10)
                ->setDetails(
                    (new \CoreProc\PayMaya\Requests\AmountDetail())
                        ->setDiscount(100.00)
                        ->setSubtotal(1721.10)
                )
        )->setTotalAmount(
            (new \CoreProc\PayMaya\Requests\TotalAmount())
                ->setValue(4863.30)
                ->setDetails(
                    (new \CoreProc\PayMaya\Requests\AmountDetail())
                        ->setDiscount(300)
                        ->setSubtotal(5163.30)
                )
        ),
    (new \CoreProc\PayMaya\Requests\Item())
        ->setName('PU Ballerina Flats')
        ->setCode('CVG-096733')
        ->setDescription('Shoes')
        ->setQuantity(1)
        ->setAmount(
            (new \CoreProc\PayMaya\Requests\ItemAmount())
                ->setValue(600)
        )->setTotalAmount(
            (new \CoreProc\PayMaya\Requests\TotalAmount())
                ->setValue(600)
        ),
])->setRedirectUrl(
    (new \CoreProc\PayMaya\Requests\RedirectUrl())
        ->setSuccess('http://shop.test/success')
        ->setFailure('http://shop.test/failure')
        ->setCancel('http://shop.test/cancel')
)->setRequestReferenceNumber('0001');

$checkoutResponse = $payMayaApi->checkout($checkout);

echo $checkoutResponse->getRedirectUrl();

Testing

No tests yet.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Chris Bautista
• All Contributors

Support us

CoreProc is a software development company that provides software development services to startups, digital/ad agencies, and enterprises.

Learn more about us on our website.

License

The MIT License (MIT). Please see License File for more information.