Transaction Details (Broker)

This API provides the details of Purchase oriented to the Broker Service. It allows you to retrieve detailed information about a Purchase using the UID of the Order. This API is useful to obtain the price of the Purchase and more relevant information. This API does not require authentication.


Show detailed information about the Success (200) result

The Success result returns the following detailed payload:

NameTypeDescription
uidStringUID of the Order. Defined as UID in Aptoide Connect channels.
domainStringPackage name of the application that originated this Purchase.
productStringSKU of the Product purchased.
wallet_fromStringString based value of the Wallet Address used in the Purchase.
typeStringType of the Product purchased.
methodStringMethod used in the Purchase. Example: credit_card
countryStringString value following the ISO-3166-1-A2 guidelines. Example: US
referenceStringThe transaction reference. Defined as orderReference in the BillingFlowParams.
hashStringHash of the transaction. Defined as TxID in the Aptoide Connect and Wallet App.
statusStringStatus of the transaction.
addedStringString based timestamp of the addition date. Example: 2025-01-14T11:06:31.231117Z
modifiedStringString based timestamp of the modification date. Example: 2025-01-14T11:06:31.231117Z
gatewayObjectObject with information of the Gateway used.
gateway.nameStringGateway name. Example: adyen_v2
metadataObjectObject with information about the Purchases metadata.
metadata.purchase_uidStringPurchase ID defined as token in the Purchase class.
metadata.developer_payloadStringString based payload specified by the Developer when initiating this Purchase.
priceObjectObject with information of the Price of the Purchase.
price.currencyStringThe currency used in the Payment, as an ISO 4217 alphabetic code. Example: USD
price.valueStringThe price value of the Payment. Example: 1.12
price.appcStringThe price value in APPC currency. Example: 1120000
price.usdStringThe price value in USD currency. Example: 1.10
price.vatObjectObject with information about the VAT.
price.vat.percentageStringPercentage of the VAT. Example: 20.5
price.vat.valueStringValue of the VAT. Example: 4.45
price.vat.usdStringValue of the VAT in USD. Example: 1.12
price.discountObjectObject with information about the Discount applied in the Purchase.
price.discount.percentageStringPercentage of the discount. Example: 20.5
price.discount.valueStringValue of the discount. Example: 4.45
price.discount.usdStringValue of the discount in USD. Example: 1.12
channelStringChannel used for the Purchase.
platformStringPlatform used for the Purchase.
marketStringMarket from which the Purchase was made.

type

ValueDescription
INAPPProduct of type inapp was purchased via Android Billing SDK.
INAPP_SUBSCRIPTIONProduct of type subscription was purchased via Android Billing SDK.
INAPP_UNMANAGEDProduct of type inapp was purchased via OSP.

status

ValueDescription
PENDING_SERVICE_AUTHORIZATIONTransaction wating for service authorization.
PENDING_USER_PAYMENTTransaction waiting for user payment.
PROCESSINGTransaction beeing processed.
SETTLEDTransaction settled.
COMPLETEDTransaction completed.
CANCELEDTransaction canceled.
DUPLICATEDTransaction duplicated.
FAILEDTransaction failed.
CHARGEBACKTransaction chargeback.
REFUNDEDTransaction refunded.

channel

ValueDescription
ANDROIDAndroid channel type used.
IOSIOS channel type used.

platform

ValueDescription
ANDROIDAndroid channel type used.
IOSIOS channel type used.

market

ValueDescription
NATIVENative market was used. Android or iOS.
WEBWeb market was used.

Language