SDKs

Qué crosses el wire

• Dónde it sits

  Entre su application y el REST interface. It builds el request, attaches el credential y el Versión de API, applies el política de reintentos y turns el response into un typed object su compiler puede check.

• Qué usted configure

  Un environment-scoped clave secreta, el Versión de API a pin, y un timeout. Everything else has un documented incumplimiento de pago. El reference para su language lists el constructor options y el exact method names.

• Qué it hands back

  UN typed model de el resource en success, y un typed error carrying el same code el raw API would have returned en failure. Su handling logic es el same either way; el SDK solo saves usted el parsing.

Cuando a use it

• Server-side integration

  Typed models catch schema mistakes en compile time rather than en production, que matters most en el request bodies usted write once y never look en again.

• Mobile acceptance

  Mobile SDKs handle tarjeta entry y tokenización sin tarjeta data touching su app code, que es qué keeps un mobile build out de PCI scope.

• Teams sin un pagos specialist

  El retry helper y el signature helper encode decisions ese son easy a get subtly wrong y expensive a get wrong quietly.

Cómo a implement SDKs

Qué fails, y cómo usted find out

• Floating el SDK version

  Un unpinned dependency puede move el Versión de API it targets, que changes response shapes sin any change en su side. Pin el package y pin el Versión de API separately.

• Wrapping el retry helper en another retry

  Un outer retry layer ese does no carry el clave de idempotencia turns one safe retry into two independent charges. Pick one layer a own retries, y let el otro pass failures mediante.

• Parsing el body antes de el signature helper sees it

  El helper needs el raw bytes. UN framework ese has already deserialized el request will make cada verification fail, y el SDK cannot tell usted ese desde inside.

• A typed error caught as a generic exception

  Catching broadly y registro de eventos técnicos el message discards el code el rest de su handling depends en. Catch el typed error, sucursal en el code, then log.

Sandbox versus production

• One client, two configurations

  El same SDK talks a both environments; solo el credential differs. Building el client desde configuration rather than hard-coding it es qué makes el cutover un deployment change instead de un code change.

• Retry behaviour es observable

  Provoking un retryable failure en entorno de pruebas (sandbox) es el solo practical way a see el helper actually retry, y a confirm su logs record one logical operation rather than several.

• Mobile SDKs need el entorno de pruebas (sandbox) clave pública para integración

  UN mobile build pointed en entorno de pruebas (sandbox) tokenizes documented test tarjetas. Shipping un build still configured ese way produces tokens production cannot charge, so el key belongs en build configuration.