Передача та звірка контрактів

Цей посібник призначений для Agent Java SDK v0.3.0, Java 8+ і публічного контракту з тегами. Приклади виконуються в серверній частині партнера після ініціалізації client у Швидкий старт.

Приклад передумов

Фрагменти Java поділяють ці імпортовані файли. Ініціалізуйте client за допомогою швидкого запуску та отримайте platformUserId із збереженого зв’язування. Приклади ідентифікаторів користувача/замовлення потрібно замінити вашими постійними значеннями.

import com.sixmm.agent.*;
import com.sixmm.agent.model.*;
import java.util.*;

Переказ фіксованої суми

Використовуйте transfer для переказів фіксованої суми. Direction.IN означає передачу з партнерської платформи на 6MM. Direction.OUT означає перенесення з 6MM назад на партнерську платформу.

Використовуйте рядки або BigDecimal для сум. Не використовуйте double або float.

Переказ через agentUserId

import com.sixmm.agent.model.Direction;
import com.sixmm.agent.model.TransferRequest;
import com.sixmm.agent.model.TransferResponse;
TransferResponse resp = client.transfer(TransferRequest.fixed(
        "AGT-ORDER-1001",
        "agent-user-001",
        Direction.IN,
        "USDT",
        "10.00"));
System.out.println(resp.orderNo);
System.out.println(resp.orderStatus);
System.out.println(resp.agentUserId);
System.out.println(resp.platformUserId);

Переказ через platformUserId

TransferResponse resp = client.transfer(TransferRequest.fixedByPlatformUserId(
        "AGT-ORDER-1002",
        "1188041528",
        Direction.OUT,
        "USDT",
        "5.00"));

Надайте обидва ідентифікатори

Якщо надано обидва ідентифікатори, служба підтверджує, що вони вказують на одне й те саме пов’язаний користувач.

TransferRequest req = TransferRequest
        .fixed("AGT-ORDER-1003", "agent-user-001", Direction.IN, "USDT", "20.00")
        .withPlatformUserId("1188041528");
TransferResponse resp = client.transfer(req);

Поля запиту:

Поля відповіді:

Підтвердження замовлення та ідемпотентність

Після виклику transfer служба агента синхронно викликає торгівлю ядро на головному шляху. У більшості випадків відповідь API уже містить синхронний торговий основний результат.

Вимоги до ідемпотентності:

• Використовуйте один agentOrderNo для однієї бізнес-операції.
• Якщо HTTP минув або мережа вийшла з ладу, спочатку надішліть той самий запит agentOrderNo.
• Webhooks можна спробувати повторно. Дедуплікуйте їх за допомогою ключа ідемпотентності.

Transfer All Out

transferAllOut переміщує баланс користувача на стороні 6MM назад до партнерська платформа.

import com.sixmm.agent.model.TransferAllOutRequest;
import com.sixmm.agent.model.TransferAllOutResponse;
TransferAllOutResponse resp = client.transferAllOut(
        TransferAllOutRequest.of("AGT-ORDER-2001", "agent-user-001", "USDT"));
System.out.println(resp.orderStatus);
System.out.println(resp.amount);

Автор platformUserId:

TransferAllOutResponse resp = client.transferAllOut(
        TransferAllOutRequest.byPlatformUserId("AGT-ORDER-2002", "1188041528", "USDT"));

amount у відповіді — фактична сума переказу.

Зворотний порядок

Реверс використовується для компенсації успішного замовлення на передачу, коли серверна частина підтримує зворотний потік. Типові випадки включають винятки місцевого замовлення партнера або ручний відкат узгодження.

import com.sixmm.agent.model.ReverseOrderRequest;
import com.sixmm.agent.model.ReverseOrderResponse;
ReverseOrderResponse resp = client.reverse(ReverseOrderRequest.of(
        "AGT-ORDER-1001",
        "REV-ORDER-1001",
        "partner order rollback"));
System.out.println(resp.orderStatus);

Поля:

Примітки:

• Реверс не є звичайною операцією скасування.
• Зворотні порядки також повинні бути ідемпотентними за номером порядку.
• Після скасування початкового замовлення webhook може підштовхнути вихідне замовлення REVERSED кінцевий стан.

Порядок запиту

import com.sixmm.agent.model.OrderQueryType;
import com.sixmm.agent.model.QueryOrderRequest;
import com.sixmm.agent.model.QueryOrderResponse;
QueryOrderResponse resp = client.queryOrder(
        QueryOrderRequest.of("AGT-ORDER-1001", OrderQueryType.TRANSFER_IN));
System.out.println(resp.status);
System.out.println(resp.failReason);

Підтримувані значення orderType:

• TRANSFER_IN
• TRANSFER_OUT

Загальні поля відповіді:

Список замовлень

import com.sixmm.agent.model.ListOrdersRequest;
import com.sixmm.agent.model.ListOrdersResponse;
ListOrdersRequest req = ListOrdersRequest.page(1, 20);
req.orderType = "TRANSFER_IN";
req.status = "SUCCESS";
req.startTime = "2026-06-01T00:00:00Z";
req.endTime = "2026-06-16T00:00:00Z";
ListOrdersResponse resp = client.listOrders(req);
System.out.println(resp.total);
resp.orders.forEach(order -> System.out.println(order.orderNo));

Рекомендації щодо сторінки:

• page починається з 1.
• Тримайте pageSize на рівні 100 або нижче.
• Для завдань узгодження сторінка за часовим вікном і дедуплікація до orderNo.

Джерело та відповідні посібники

• Офіційне джерело v0.3.0
• Огляд запиту та розбивка на сторінки
• Гаманець для фінансування
• Посібник з оновлення

Зворотні дзвінки на події

transfer.completed може містити SUCCESS, FAILED або оригінальне оновлення замовлення REVERSED; reverse.completed — термінальна подія сторнованого замовлення. transfer.dead означає, що остаточний стан залишається непідтвердженим після повторних спроб і потребує узгодження вручну, а не підтвердженої помилки. Сама по собі назва події не свідчить про зарахування коштів.

Успішне підтвердження відрізняється від успішного руху коштів: після запису дійсного сповіщення targetStatus=FAILED також поверніть HTTP 2xx. Постійна дедуплікація фінансових подій orderType:orderId:targetStatus у межах сфери дії продавця та environment.

Поля подій і JSON приклади · Перевірка підпису, відповіді та повторні спроби