AcquirerCallbackService link
Acquirer-implemented callbacks t-0 pushes — authorization, settlement
progress, and expiry. Delivered at least once and deduped on the t-0 id.
AcquirerService link
t-0 endpoints the Acquirer calls to price a sale, open a payment intent, and
confirm fiat receipt.
Requests And Response Types link
AcquirerPaymentExpiredRequest link
PaymentExpired is also a method on IssuerService in this flat
package, so the request/response carry a role prefix to avoid a colliding
PaymentExpiredRequest. Interim name: buf STANDARD RPC_REQUEST_STANDARD_NAME
accepts only bare PaymentExpiredRequest or the full
AcquirerCallbackServicePaymentExpiredRequest, so this short form needs a
lint ignore at graduation (or rename the method).
AcquirerPaymentExpiredResponse link
This message has no fields defined.
CreatePaymentIntentRequest link
CreatePaymentIntentRequest.FiatSettlementTerms link
Reference to a standing quote when the Acquirer is settled in fiat via an LP.
| Field | Type | Label | Description |
|---|
| quote_id | uint64 | | Standing quote obtained from GetPaymentQuote; supplies local_currency and fx_rate. |
CreatePaymentIntentRequest.UsdtSettlementTerms link
Acquirer-supplied terms when it settles in USDt and runs its own FX.
| Field | Type | Label | Description |
|---|
| local_currency | string | | ISO 4217 currency the merchant quoted the customer in. |
| fx_rate | tzero.v1.common.Decimal | | Units of local_currency per 1 USDt, set by the Acquirer. |
CreatePaymentIntentResponse link
CreatePaymentIntentResponse.Failure link
CreatePaymentIntentResponse.Success link
GetPaymentQuoteRequest link
GetPaymentQuoteResponse link
GetPaymentQuoteResponse.Failure link
GetPaymentQuoteResponse.Success link
PaymentAuthorizedRequest link
PaymentAuthorizedResponse link
This message has no fields defined.
SettlementCompletedRequest link
| Field | Type | Label | Description |
|---|
| settlement_id | uint64 | | |
| settlement_amount | tzero.v1.common.Decimal | | Amount the Acquirer actually received; currency set by the settlement variant. |
| settled_payment_intent_ids | uint64 | repeated | |
| settled_at | google.protobuf.Timestamp | | |
| settlement | OnChainSettlementDetails | | The on-chain USDt settlement that reached the Acquirer. USDt mode only — fiat mode has no SettlementCompleted (the Acquirer’s SettlementReceived is terminal). |
SettlementCompletedResponse link
This message has no fields defined.
SettlementInitiatedRequest link
| Field | Type | Label | Description |
|---|
| fiat_settlement_id | uint64 | | t-0’s id for this fiat settlement (the fiatSettlementId); the bank-rails leg’s key. |
| lp_id | uint64 | | t-0’s id for the LP that sent the transfer; scopes bank_transfer_ref. |
| bank_transfer_ref | string | | Reference the LP put on the bank-rails transfer; matched against the statement. |
| settled_payment_intent_ids | uint64 | repeated | Intents this settlement clears, resolved by t-0 from the LP’s executions. |
| local_currency | string | | |
| settlement_amount | tzero.v1.common.Decimal | | |
| initiated_at | google.protobuf.Timestamp | | |
SettlementInitiatedResponse link
This message has no fields defined.
SettlementReceivedRequest link
SettlementReceivedResponse link
SettlementReceivedResponse.Accepted link
This message has no fields defined.
SettlementReceivedResponse.Rejected link
CreatePaymentIntentResponse.Failure.Reason link
| Name | Number | Description |
|---|
| REASON_UNSPECIFIED | 0 | |
| REASON_ISSUER_UNAVAILABLE | 10 | The Issuer could not be reached to allocate instructions. |
| REASON_ADDRESS_POOL_EMPTY | 20 | The Issuer has no free one-time deposit addresses. |
| REASON_AMOUNT_OUT_OF_RANGE | 40 | The amount falls outside the acceptable range. |
| REASON_QUOTE_EXPIRED | 50 | The referenced quote no longer stands. |
| REASON_QUOTE_INSUFFICIENT_HEADROOM | 70 | The quote’s remaining validity is too short to guarantee execution before it expires. |
GetPaymentQuoteResponse.Failure.Reason link
| Name | Number | Description |
|---|
| REASON_UNSPECIFIED | 0 | |
| REASON_QUOTE_UNAVAILABLE | 10 | No standing quote available for this currency (LP not quoting it now, or not enabled for this Acquirer). |
| REASON_AMOUNT_OUT_OF_RANGE | 30 | No standing quote’s per-sale USDt bounds cover the request amount. |
SettlementReceivedResponse.Rejected.Reason link
| Name | Number | Description |
|---|
| REASON_UNSPECIFIED | 0 | |
| REASON_AMOUNT_MISMATCH | 10 | amount_received does not equal the matched transfer’s settlement amount. |
| REASON_UNKNOWN_TRANSFER | 20 | No fiat settlement matches the (lp_id, bank_transfer_ref) pair. |