Skip to main content

Payment

Auth: Partner API authentication

payment_summary

Endpoint: https://app.partnerboost.com/api.php?mod=medium&op=payment_summary

Required parameters

Provide either payment_id or both paid_date_begin and paid_date_end.

KeyDescription
tokenChannel API token
payment_idPayment id (payment_id or paid_date_begin and paid_date_end are mandatory)
paid_date_beginPaid date period. Format: YYYY-MM-DD (payment_id or paid_date_begin and paid_date_end are mandatory)
paid_date_endPaid date period. Format: YYYY-MM-DD (payment_id or paid_date_begin and paid_date_end are mandatory)

Optional parameters

KeyDescription
typeReturn format: json (default) or xml
pageCurrent page index
limitNumber of transactions shown per page - max 2000 transactions per page
payment_currencyThe currency used when paying the commission for the brand to you. Available filter: USD, EUR, GBP. Multiple currencies separated by commas.

Return fields

KeyDescription
payment_idThe payment ID found under payment history
request_dateDate when the payment has been created. Format: YYYY-MM-DD
paid_dateDate when the payment is marked paid. Format: YYYY-MM-DD
payment_typePayment type
payment_detailsAccount information
invoiceInvoice information
AmountPayment amount
payment_currencyThe currency used when paying the commission for the brand to you. Available Filter: USD, EUR, GBP. Multiple currencies separated by commas.

Request:

{
"token": "YOUR_CHANNEL_TOKEN",
"paid_date_begin": "2024-01-01",
"paid_date_end": "2024-01-31"
}

payment_detail

Endpoint: https://app.partnerboost.com/api.php?mod=medium&op=payment_detail

Required parameters

Same as payment_summary: provide either payment_id or both paid_date_begin and paid_date_end.

KeyDescription
tokenChannel API token
payment_idPayment id (payment_id or paid_date_begin and paid_date_end are mandatory)
paid_date_beginPaid date period. Format: YYYY-MM-DD (payment_id or paid_date_begin and paid_date_end are mandatory)
paid_date_endPaid date period. Format: YYYY-MM-DD (payment_id or paid_date_begin and paid_date_end are mandatory)

Optional parameters

KeyDescription
typeReturn format: json (default) or xml
validation_date_beginValidation date period. Format: YYYY-MM-DD
validation_date_endValidation date period. Format: YYYY-MM-DD
pageCurrent page index
limitNumber of transactions shown per page - max 2000 transactions per page
payment_currencyThe currency used when paying the commission for the brand to you. Available filter: USD, EUR, GBP. Multiple currencies separated by commas.

Return fields

KeyDescription
brand_idBrand ID, a series of numbers, like 66303
mcidUnique identifier for the brand, a series of characters, like ulike0
m_idDeprecated, for removal. This parameter is subject to removal in a future version.
amountCommission amount or bonus amount
validation_dateDate when commission is approved and ready for you to withdraw
typeType could be commission or bonus
noteThis indicates the time period the amount is generated
settlement_idA unique id indicates approved commission by merchant
merchant_nameMerchant Name
payment_idThe payment ID found under payment history
paid_dateDate when the payment is marked paid. Format: YYYY-MM-DD
sign_idRecord unique identifier
payment_currencyThe currency used when paying the commission for the brand to you. Available Filter: USD, EUR, GBP. Multiple currencies separated by commas.

Request:

{
"token": "YOUR_CHANNEL_TOKEN",
"payment_id": "3949"
}