Release Notes

Updates to the Selva API platform, including payments, account management, and more.

API Endpoint Structure Changes

Phone information endpoint changed from query parameter to path parameter:
- Old: GET /phone/information?phone_number=88881234
- New: GET /phone/information/{phone_number}
IBAN information endpoint changed from query parameter to path parameter:
- Old: GET /iban/information?iban=CR01...
- New: GET /iban/information/{iban}

Response Format Changes

Document numbers in payment responses now return raw database format instead of formatted version:
- Old: "1-2345-6789" (formatted)
- New: "123456789" (raw database format)
Balance data format changed to integer (in cents) with new formatted field:
- Old: {"balance": 1250.50}
- New: {"balance": 125050, "formatted": "1,250.50 CRC"}

Authentication Requirements

X-Idempotency-Key header is now required for all payment endpoints (was previously optional)
Missing header will result in HTTP 400 Bad Request

Error Code Changes

Webhook subscription state conflicts now return HTTP 409 Conflict instead of HTTP 400 Bad Request:
- Attempting to suspend an already-suspended subscription
- Attempting to resume a non-suspended subscription

Enhanced Account Lookups

Added internal SELVA account lookup for IBAN information (when IBAN belongs to SELVA)
Added internal account lookup for phone information (when phone belongs to SELVA user)
Internal lookups bypass external SINPE API calls for faster responses

Validation Improvements

Added idempotency key uniqueness validation on /validate endpoint
Returns HTTP 409 Conflict if payment already processed with same idempotency key
Added bail flag to payment validation for faster failure on first error

Payment Response Enhancements

Account Details Response Update

GET /api/accounts/{id}/details now returns origin_code as a string and includes owner_name, document_number, iban, currency, status, and timestamps; deprecated user_id and document_type fields removed

API Improvements