Rakmao Payment | Payout Flow

# Rakmao Payment/Payout Workflow [T] = Table (In database) [F] = Function (In C#) ## Payment Flow ```mermaid --- title: Payment Flow --- flowchart TD subgraph BA ["Buyer Actor"] A(Start) B[/"Approve PO"/] C{"Select payment method"} OPN["OPN (QR Code)"] CREDIT["KPG (CreditCard)"] PARTNER["Partner"] OPN_2["Scan QR Code"] CREDIT_2["Enter card detail"] CREDIT_3["3DS authorize"] ACP["Accept Delivery"] end subgraph SYSA ["System Actor"] OPN_3["Cash transafer from customer bank to OPN payment gateway account"] CREDIT_4["Credit deduct on customer CC account"] CREDIT_5["Credit deduct on KPG payment gateway for merchant account"] end subgraph RSA ["Rakmao System Actor"] CB["Callback to Rakmao"] CB_1["Update transaction paid status"] CB_2["Callback to Seller"] AFTER_CB["Create payout transaction ([F]AddPendingPayoutTransaction)"] DEC{"Payment via OPN"} end rsa["Rakmao System Actor"] subgraph SLA ["Seller Actor"] SL["Accept payment transaction"] SL2["Update delivery date"] SL3["Delivery"] end sla["Seller Actor"] subgraph ROA ["Rakmao Officer Actor"] OPN_4["End of day transfer cash from OPN account to KGP bank account for Rakmao (002)"] end CB --> CB_1 --> CB_2 SL --> SL2 --> SL3 C --> OPN --> OPN_2 --> OPN_3 --> CB C --> CREDIT --> CREDIT_2 --> CREDIT_3 --> CREDIT_4 --> CREDIT_5 --> rsa CB_2 --> sla --> ACP --> AFTER_CB --> DEC DEC --> YES --> ROA --> END1 DEC --> NO --> END A --> B --> C --> PARTNER --> END END["END"] END1["END (with cash on rakmao bank account)"] ``` ## Payout Flow ```mermaid --- title: Payout Flow --- flowchart TD subgraph "System Actor" A(Start) end subgraph "Schedule" SCH1["Everyday at 07.15 UTC+7"] SCH2["Everyday at 10.01 UTC+7"] end subgraph CDB ["Create Draft batchs"] CDB1["Get payout config from DB"] CDB2["Get PayoutTransaction not assign to Batch"] CDB3["Group transaction with AppId (TransGroup)"] CDB4["Get Payment transactions "] CDB5["Get App Profile "] CDB6["Remap model with group of seller combine key (SellerGroup)"] CDB7{"Have SellerGroup"} CDB8{"Any BatchId is null in TransGroup"} CDB9{"Have batchId is null in TransGroup"} CDB10{"Payout amount over config"} CDB11{"Check payout amount with accumulate"} CDB12["Update accumulate value"] CDB13["Update this seller batch"] CDB14{"noRequireCashIn and iskgpMethod and payoutTransactionAlreadyCreate"} CDB15["Insert PayoutPayment line with trnsaction data"] CDB16{"Check split batch"} CDB17["Update batch are split"] CDB18["insert batch"] CDB19{"cashIn > 0 "} CDB20["insert PayoutPayment with transaction amount "] CDB21{"subsidize > 0 "} CDB22["insert PayoutPayment with discount amount "] CDB23["save to DB"] END_CDB["END"] end cdb_node('Create Draft batchs') A --> SCH1 --> cdb_node --> END CDB1 --> CDB2 --> CDB3 --> CDB4 -->CDB5 -->CDB6 --> CDB7 --> CDB8 CDB8 --> CDB9 --> CDB10 --> CDB11 --> CDB12 --> CDB13 --> CDB14 CDB14 --> CDB15 --> CDB16 --> CDB17 --> CDB18 --> CDB19 --> CDB20 CDB20 --> CDB21 --> CDB22 --> CDB9 CDB9 --> CDB8 CDB11 --> CDB9 CDB14 --> CDB16 CDB16 --> CDB18 CDB19 --> CDB21 CDB21 --> CDB9 CDB7 --> END_CDB CDB8 --> CDB23 --> END_CDB CDB10 --> END_CDB END("End") ``` ## Summary After Payment Flow ```mermaid --- title: "After payment" --- flowchart TD A(Start) --> B[\Seller deilvered order/] B --> C[\Transaction payment success/] C --> D[[Update Table Transactions]] D --> E[/"Create rows with [F]AddPendingPayoutTransaction"/] E --> F[["Insert [T] TransactionPayout"]] F --> G(End) ``` ## Function flow ### AddPendingPayoutTransaction #### TODO : Update to lastest ```mermaid --- title: "[F]AddPendingPayoutTransaction" --- flowchart TD A[Start] --> B{"Find eligible transaction (Completed, Not yet paid)"}; B -- Not Found --> C[End]; B -- Found --> D[Get Merchant, Campaigns, & Payout Config]; D --> E["Calculate Amounts: - PayoutAmount = GrandTotal of PaymentTransaction without seller discount - CashoutAmount = GrandTotal of PaymentTransaction via none KGP Payment gateway without seller discount and Platform discount - SubsidizeAmount = Platform discount "]; E --> F{PayoutAmount <= BatchLimit?}; subgraph "Simple Payout (Amount under or equal limit)" F -- Yes --> G[Create a single PayoutTransaction]; G --> Z[Save to Database]; end subgraph "Split Payout" F -- No --> H[Calculate Multiples & Fractions for Cashout and Subsidize amounts]; H --> I[Create new List for PayoutTransactions]; I --> J{Cashout batches to create > 0?}; J -- Yes --> K[Loop & Create PayoutTransactions for full Cashout batches]; K --> L; J -- No --> L; L{Remaining cashout fraction > 0?}; L -- Yes --> M[Create PayoutTransaction for remaining Cashout fraction]; M --> N; L -- No --> N; N{Subsidize batches to create > 0?}; N -- Yes --> O[Loop & Create PayoutTransactions for full Subsidize batches]; O --> P; N -- No --> P; P{Remaining subsidize fraction > 0?}; P -- Yes --> Q[Create PayoutTransaction for remaining Subsidize fraction]; Q --> R; P -- No --> R; R[Add the list of new transactions] --> Z; end Z --> C; ``` ### ApproveBatchDraft ```mermaid --- title: "Create Batch Draft" --- flowchart TD A[Start] --> B["Get Payout Configurations"]; B --> C{"Ratio > 100%"}; C -- Yes --> D[Throw Error]; C -- No --> E["Get Unbatched [T]PayoutTransactions"]; E --> F{"Any Transactions Found?"}; F -- No --> G[End]; F -- Yes --> H["Group Transactions by Seller-CombineKey"]; H --> I[Get Seller Details]; I --> J["Initialize empty lists for [T]PayoutBatch & [T]PayoutPayment"]; J --> K[For each Transaction Group]; subgraph "Batch Creation Loop" K --> L{"While Group has unbatched transactions"}; L -- No --> M[Next Group]; M --> K; L -- Yes --> N["Initialize batch variables (accumulators, counters, new IDs)"]; N --> O["For each unbatched transaction 'trans' in the group"]; O --> P{"trans.PayoutAmount > batchLimit?"}; P -- Yes --> Q[Throw ArgumentException]; P -- No --> R{"Accumulated Payout + trans.PayoutAmount <= batchLimit?"}; R -- No --> S[Process next transaction]; S --> O; R -- Yes --> T["Add 'trans' amount to accumulators Update 'trans' with batch/payment IDs"]; T --> U{trans.IsDocumentSplit?}; U -- Yes --> V[Set isContainSplit = true]; V --> S; U -- No --> S; end subgraph "Finalize and Save" O -- Loop Finished --> W[Create new PayoutBatch object from accumulated values]; W --> X{transactionCashoutAmount > 0?}; X -- Yes --> Y[Create PayoutPayment for Transaction cashout]; Y --> Z; X -- No --> Z; Z{subsidizeCashoutAmount > 0?}; Z -- Yes --> AA[Create PayoutPayment for Subsidize cashout]; AA --> L; Z -- No --> L; end K -- All Groups Processed --> AB{Any Batches Created?}; AB -- No --> G; AB -- Yes --> AC[Add Batches & Payments to context]; AC --> AD[Save Changes to Database]; AD --> G; ```