Andorpay
Back to the blog

Published on · Updated on

Payment SDK or direct API: how to choose an integration

Check maintenance, compatibility and test coverage before adopting a payment SDK. Separate provider connectivity from your order and subscription logic.

Integration modules connect a laptop to a payment card.

An SDK can simplify calls to a payment API, but it does not decide how your orders or subscriptions should work. Choose against the provider’s contract, your project language and the maintenance you can support.

What work can it handle?

A library may help build requests, signatures, responses and error handling. Check its exact scope. Returning a payment object does not mean the sale has been updated, a document sent or service access opened.

Before adding the dependency

Check Evidence to look for
Origin Official provider library or clearly identified third-party project
Compatibility Supported language, runtime and API versions
Maintenance Recent releases and issue handling
Contract Available operations, parameters and errors
Integration security Response validation and secret handling
Testing Reproducible examples in the test environment

A library using the processor’s name is not necessarily official. Record the version you have checked; instructions for another version may not apply.

SDK versus direct API calls

With an SDK, a dependency handles some connection code. Direct API calls leave more preparation and maintenance with your team. Either way, your application must connect the sale, payment request and result. Both approaches may use the same API.

A minimal journey is: application determines amount → operation created → customer pays → server validates result → sale updated once.

What should you test?

Check a valid response, invalid response, decline, timeout and repeated notification. A timeout leaves an outcome to resolve; it is not permission to charge again automatically. Our testing matrix separates these cases.

If you are also choosing the payment screen, see hosted checkout and APIs. A hosted checkout can itself use an API integration.

Start with AndorPay’s documentation, in Spanish, then check operations against the provider’s documentation before implementing them.

WhatsApp