Merchant Interaction

Merchant interaction involves integrating with various wallet services to manage sessions, payments, customers, webhooks, reporting, and migrations. This section provides an overview of the key services and their main endpoints, with references to detailed documentation for each area.

Service Overview & Key Endpoints

• wallet-auth-service

  • POST v1/sessions, GET v1/sessions
  • Session API Reference
  • Session Configuration Guide

• wallet-payment-service

  • POST v1/payments, GET v1/payment by paymentId, GET v1/payment by merchantTransactionId, PATCH v1/capture-payment, POST v1/refund, GET v1/refund by refund id, POST v1/token/create-payments, GET v1/token/payment by paymentId
  • Payments API Reference
  • Payment Lifecycle
  • Refunds Guide
  • Split Tender Backward Compatibility

• wallet-customer-service

  • POST v1/find-payment-method-search, GET v1/payment-method by paymentMethodId, PATCH v1/update-payment-method by paymentMethodId, DELETE v1/delete-payment-method by paymentMethodId, POST v1/token/set-up-payment-method, GET v1/token/set-up-payment-method by setupPaymentMethodId
  • Payment Methods API Reference
  • Customer Creation
  • Enterprise Settings Logic

• wallet-merchant-service

  • Webhooks: payments, payment-method
  • Webhooks Guide

• wallet-reporting-service

  • Payout report, combined payout report
  • Reporting Options

• wallet-migration-service

  • Migration file via ECG from merchant for Card and ACH

Additional Resources

• API Terminology
• Merchant Settings
• Troubleshooting Guide

For detailed request/response payloads and error codes, see the API Reference.