Skip to main content

SATIM Overview

Use this page to understand the full flow, then continue with role-specific docs:

1. End-to-End Payment Flow​

  1. Customer confirms an order on the merchant website.
  2. Merchant generates a unique orderNumber (exactly 10 alphanumeric characters).
  3. Merchant creates a payment_attempts row with status initiated.
  4. Merchant calls SATIM register.do.
  5. SATIM returns orderId and formUrl.
  6. Merchant updates payment_attempts (registered or registered_failed) and stores SATIM register payloads.
  7. Merchant redirects customer to formUrl.
  8. SATIM redirects customer to merchant returnUrl or failUrl.
  9. Merchant calls acknowledgeTransaction.do with mdOrder.
  10. Merchant updates payment_attempts (acknowledged or acknowledge_failed) and stores SATIM acknowledge payloads.
  11. Merchant persists a transactions row linked to payment_attempts (even on acknowledge failure).
  12. Merchant displays the final result page.

2. SATIM Test Endpoints​

  • Register order: https://test2.satim.dz/payment/rest/register.do
  • Acknowledge transaction: https://test2.satim.dz/payment/rest/public/acknowledgeTransaction.do
HTTP method

Use HTTP POST for SATIM API calls, even if some examples show GET.

Integration Window

The SATIM integration period is fixed at 15 days from Tech Lead activation on the SATIM platform. During this period, request SATIM test cards (jeu de cartes) from the Tech Lead for local testing before pushing code to Git.

3. Implementation Map​

  • Backend: data model, status lifecycle, register.do, acknowledgeTransaction.do.
  • Frontend: IHM/UX constraints, return-page behavior, receipt actions.
  • Certification: consolidated go-live validation checklist.

4. Team Coordination Requirement​

  • Frontend and backend teams should coordinate development closely (shared milestones, API contracts, payload validation, and end-to-end testing).
  • Effective cross-team coordination is required to keep the SATIM implementation smooth and efficient and to improve certification success.