{ "_comment": "Confirming a sale by querying POST /get-transactions with the seller's MPL and your order id, for partners and direct sellers alike. Each case gives your local order, PayMe's full response, and the expected result. Envelope: {status_code, session, items_count, items[]}; timestamps 'Y-m-d H:i:s'; enum fields as strings. A sale refunded in full through several partial refunds stays 'partial-refund'; 'refunded' needs one refund for the full amount from a non-partial status. All values are fake.", "case_count": 18, "order": { "order_id": "order-0001", "payme_sale_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "price_minor": 5075, "currency": "ILS" }, "cases": [ { "name": "paid sale that matches the order (full row as PayMe returns it)", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 1, "items": [ { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "completed", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 5075, "seller_id": null, "sale_payme_code": 12345678, "sale_type": 1, "transaction_type": 1, "transaction_action": "Debit", "sale_description": "Ceramic mug", "sale_installments": 1, "sale_payment_method": "credit-card", "transaction_payment_method": "credit-card", "transaction_price_after_fees": 4920, "sale_auth_number": "0000000", "sale_is_3ds": true, "transaction_release_date": "2026-11-13", "transaction_error_code": null, "transaction_error_text": null, "transaction_is_matched": false, "transaction_match_statuses": [], "transaction_is_canceled": false, "transaction_comment": null, "sale_fees": { "sale_processing_fee": 0, "sale_market_fee": 0 }, "sale_buyer_details": { "buyer_card_mask": "532610******5846", "buyer_card_brand": "mastercard", "buyer_card_is_foreign": false, "buyer_name": "Test Buyer", "buyer_email": "buyer@example.com" } } ] }, "expected": { "ok": true, "sale_status": "completed", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001" } }, { "name": "no rows: fail closed", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 0, "items": [] }, "expected": { "ok": false } }, { "name": "envelope without items: fail closed", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 0 }, "expected": { "ok": false } }, { "name": "rows only for another sale (e.g. a replayed sale id): fail", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 1, "items": [ { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000999", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "completed", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 500 } ] }, "expected": { "ok": false } }, { "name": "row reports a different order id: fail", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 1, "items": [ { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-9999", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "completed", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 5075 } ] }, "expected": { "ok": false } }, { "name": "row under a different seller: fail", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 1, "items": [ { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-7654321", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "completed", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 5075 } ] }, "expected": { "ok": false } }, { "name": "currency mismatch: fail", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 1, "items": [ { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "completed", "transaction_status": "validated", "sale_currency": "USD", "transaction_price": 5075 } ] }, "expected": { "ok": false } }, { "name": "completed but no transaction for the order amount: fail", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 1, "items": [ { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "completed", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 500 } ] }, "expected": { "ok": false } }, { "name": "authorized but no transaction for the order amount: fail", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 1, "items": [ { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "authorized", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 500 } ] }, "expected": { "ok": false } }, { "name": "authorized for the order amount: ok", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 1, "items": [ { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "authorized", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 5075 } ] }, "expected": { "ok": true, "sale_status": "authorized", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001" } }, { "name": "failed sale needs no amount match", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 1, "items": [ { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "failed", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 0 } ] }, "expected": { "ok": true, "sale_status": "failed", "payme_transaction_id": null } }, { "name": "newest transaction carries the status (rows out of order)", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 2, "items": [ { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000002", "transaction_created_at": "2026-10-14 09:00:00", "sale_status": "partial-refund", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 1000 }, { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "completed", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 5075 } ] }, "expected": { "ok": true, "sale_status": "partial-refund", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001" } }, { "name": "newest by time, not by PayMe's row order: capture listed before its authorization", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 2, "items": [ { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000002", "transaction_created_at": "2026-10-13 10:05:00", "sale_status": "completed", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 5075 }, { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "authorized", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 5075 } ] }, "expected": { "ok": true, "sale_status": "completed" } }, { "name": "rows for other sales alongside are ignored", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 2, "items": [ { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000002", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "completed", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 5075 }, { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "completed", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 5075 } ] }, "expected": { "ok": true, "sale_status": "completed", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001" } }, { "name": "absent fields are unknown, not a mismatch", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 1, "items": [ { "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "completed", "transaction_status": "validated", "transaction_price": 5075 } ] }, "expected": { "ok": true, "sale_status": "completed", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001" } }, { "name": "row without sale_status: fail", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 1, "items": [ { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 5075 } ] }, "expected": { "ok": false } }, { "name": "rows of another seller anywhere in the answer: discard and alert", "response": { "status_code": 0, "items_count": 2, "items": [ { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-7654321", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000009", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "completed", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 5075, "seller_id": null, "sale_payme_code": 12345678, "sale_type": 1, "transaction_type": 1, "transaction_action": "Debit", "sale_description": "Ceramic mug", "sale_installments": 1, "sale_payment_method": "credit-card", "transaction_payment_method": "credit-card", "transaction_price_after_fees": 4920, "sale_auth_number": "0000000", "sale_is_3ds": true, "transaction_release_date": "2026-11-13", "transaction_error_code": null, "transaction_error_text": null, "transaction_is_matched": false, "transaction_match_statuses": [], "transaction_is_canceled": false, "transaction_comment": null, "sale_fees": { "sale_processing_fee": 0, "sale_market_fee": 0 }, "sale_buyer_details": { "buyer_card_mask": "532610******5846", "buyer_card_brand": "mastercard", "buyer_card_is_foreign": false, "buyer_name": "Test Buyer", "buyer_email": "buyer@example.com" } }, { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "completed", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 5075, "seller_id": null, "sale_payme_code": 12345678, "sale_type": 1, "transaction_type": 1, "transaction_action": "Debit", "sale_description": "Ceramic mug", "sale_installments": 1, "sale_payment_method": "credit-card", "transaction_payment_method": "credit-card", "transaction_price_after_fees": 4920, "sale_auth_number": "0000000", "sale_is_3ds": true, "transaction_release_date": "2026-11-13", "transaction_error_code": null, "transaction_error_text": null, "transaction_is_matched": false, "transaction_match_statuses": [], "transaction_is_canceled": false, "transaction_comment": null, "sale_fees": { "sale_processing_fee": 0, "sale_market_fee": 0 }, "sale_buyer_details": { "buyer_card_mask": "532610******5846", "buyer_card_brand": "mastercard", "buyer_card_is_foreign": false, "buyer_name": "Test Buyer", "buyer_email": "buyer@example.com" } } ] }, "expected": { "ok": false } }, { "name": "refunded in full through two partial refunds stays partial-refund", "response": { "status_code": 0, "session": "EXAMPLE0", "items_count": 3, "items": [ { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001", "transaction_created_at": "2026-10-13 10:00:00", "sale_status": "partial-refund", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 5075 }, { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000002", "transaction_created_at": "2026-10-14 09:00:00", "sale_status": "partial-refund", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 2000, "transaction_action": "Partial Refund" }, { "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567", "sale_payme_id": "SALE0000-EXAMPLE0-SALE0000-00000001", "transaction_id": "order-0001", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000003", "transaction_created_at": "2026-10-15 09:00:00", "sale_status": "partial-refund", "transaction_status": "validated", "sale_currency": "ILS", "transaction_price": 3075, "transaction_action": "Partial Refund" } ] }, "expected": { "ok": true, "sale_status": "partial-refund", "payme_transaction_id": "TRAN0000-EXAMPLE0-TRANSACT-00000001" } } ] }