# XENDIT/TRANSACTION # Payout Payout related transactions # Payout request for buyer and seller

##### Notes - There is additional fee Rp 2.500 in [this page](https://www.xendit.co/en-id/pricing/?utm_source=google&utm_medium=cpc&utm_campaign=BKWS-Exact-ID-EN&utm_content=onboarding&utm_term=xendit%20pricing&gclid=Cj0KCQiAw6yuBhDrARIsACf94RUCuOcFXMmocbjeh-8r39r8ZdgH0_wNvL09ga8gcmrneNkHvLn8kqcaAuGREALw_wcB), but at the time we test, there is no additional cuts to recipient nor from xendit. ##### Endpoint

Endpoint	Source	Method	Authentication
/payout/request	USAPI	POST	Yes

##### Authentication

Type	Token source	Usage
Bearer	argon2id encryption vlskdfgn>iow358u2rlwnfe!@23q58qwegdf	"Bearer <string>"

##### Body request ```json { "username": , "amount": , "platform" : , "bank_channel": , "bank_account_name": , "bank_account_number": } ```

Properties	Properties of	Data type	Required	notes
username		string	yes	Username affiliated for payout from USAPI
amount		integer	yes	minimum amount is 50000
platform		string	yes	Platform lists: - ONDELIVERY - ONMARKET
bank\_channel		string	yes	ID of Bank channel. Click the provided link for the list [Bank List Link](https://documentation.onindonesia.id/books/xendittransaction/page/bank-list "Bank List Link")
bank\_account\_name		string	yes	Bank account holder name.
bank\_account\_number		string	yes	Bank account number.

Request example

```json { "username": "usernew1", "amount": 60000, "platform": "ONMARKET", "bank_channel": "ID_BCA", "bank_account_name": "TEST", "bank_account_number": "000000" } ```

Result example

200 (OK)

```javascript { "message": "PAYOUT PROCESSED" } ```

Error example

400 Bad Request

User balance is less than requested amount

```json { "message": "Insufficient Fund" } ```

Requested amount is less than minimum amount

```json { "message": "must be >= 10000" } ```

Parameter(s) required

```json { "message": "Must have required property " } ```

500 Internal Server Error

```json { "message": "Internal Error" } ```

# Invoice Invoice for xendit transaction # Invoice checkout #### Flowchart

##### Source: [https://cahskuy.stoplight.io/docs/OND/3c78799259e69-payment-checkout](https://cahskuy.stoplight.io/docs/OND/3c78799259e69-payment-checkout) Reference: [Transaction Flowchart](https://documentation.onindonesia.id/books/getting-started/page/transaction-flowchart) ##### Endpoint

Endpoint	Method	Authentication
/payment-checkout	POST	Yes

##### Authentication

Type	Token source	Server	Description
Bearer	{{usapi}}/auth	USAPI	Buyer's auth

##### Body request example ```json { "total_amount": 40000, "service": "ONMARKET", "source": "XENDIT", "transaction": [ { "amount": 10000, "freight_charge": 5000, "insurance_amount": 100, "commission_onmarket": 1000, "seller_username": "testing123", "invoice_onmarket": "INV/ONM/20240124-002B0001" }, { "amount": 20000, "freight_charge": 5000, "insurance_amount": 100, "commission_onmarket": 1000, "seller_username": "testing12345", "invoice_onmarket": "INV/ONM/20240124-002B0002" } ] } ```

Properties	Properties of	Data type	Required	Description
total\_amount		integer	yes	Total nominal amount for the invoice.
service		string	yes	ONINDONESIA services. Possible values: - ONDELIVERY means the source of the transaction comes from ondelivery. - ONTICKET means the source of the transaction comes from onticket. - ONMARKET means the source of the transaction comes from onmarket.
source		string	yes	A way that users pay for a product or service. Possible values: XENDIT, BALANCE, QRIS.
transaction		array<object>	yes	List of transactions.
amount	transaction	integer	yes	Amount of transaction for each store (do not include freight charge and insurance as they'll put in other parameter).
freight\_charge	transaction	integer	yes	Amount of freight charge for each store.
insurance\_amount	transaction	integer	no	Amount of insurance for each store.
seller\_username	transaction	string	yes	Seller ONMARKET username
invoice\_onmarket	transaction	string	yes	Invoice ID generated by ONMARKET
commission\_onmarket	transaction	integer	yes	Commission amount charged to seller

Response example

200 (OK)

Example response for ONMARKET

```json { "payment_url": "https://checkout-staging.xendit.co/latest/65ba1b78f603539c068ef753", "invoice": "ONM0001N11V0000x", "xendit_invoice": "65ba1b78f603539c068ef753", "expired_at": "2024-01-31T12:05:44.155Z", "transaction": [ { "invoice_onmarket": "INV/ONM/20240124-002B0001", "status": "PENDING" }, { "invoice_onmarket": "INV/ONM/20240124-002B0002", "status": "PENDING" } ] } ```

Properties	Properties of	Data type	Description
xendit\_invoice		string	invoice ID generated by XENDIT and translated by USAPI
payment\_url		string	Public URL for this invoice
expired\_at		timestampz	ISO date and time that the invoice expires.
transaction		array<object>	List of transactions
invoice	transaction	string	Invoice ID generated by USAPI
status	transaction	string	Status showing whether the invoice has been paid Possible values: - PENDING means the invoice has been successfully created but yet to be paid - PAID means the invoice has been paid - EXPIRED means the invoice expired before your customer paid

Example for response ONMARKET with source QRIS

```json { "invoice": "ONM00001N14U00001", "xendit_invoice": "qr_7807d58a-3d60-4425-92f9-23d6717701f6", "qr_string": "00020101021226570011ID.DANA.WWW011893600915060486424802096048642480303UKE51440014ID.CO.QRIS.WWW0215ID20243148326170303UKE52048999530336054031005802ID5925PT OnIndonesia Sistem Tek6015Kota Jakarta Ut61051424062720115NT2YP2fE3fetkbx60490011ID.DANA.WWW0425MER2021071400774509608641050116304DE92", "amount": 100, "expired_at": "2024-04-30T05:00:52.643Z" } ```

Error response

400 Bad Request

> Some parameters may contain invalid values or some parameters are not present. ```json { "message": "Invalid JSON Format" } ``` > Balance is not enough for doing transaction ```json { "message": "Insufficient balance" } ```

401 Unauthorized

> Authentication header is not valid or missing ```json { "message": "Auth Error" } ```

500 Internal server error

> Internal server error ```json { "message": "Internal server error" } ```

# Get invoice ##### Flowchart

##### Endpoint

Endpoint	Method	Authentication
/invoice/detail	GET	yes

##### Authentication

Type	Token source	Server
Bearer	{{USAPI}}/auth	USAPI

##### Param request

Properties	Required	Description
invoice	yes	invoice ID generated by USAPI
waybill_number	yes	Waybill Number generated by OSAS

Notes: Choose one of param request link example: demousapi.onindonesia.id/invoice/detail?invoice=OD0001N12D0000b or demousapi.onindonesia.id/invoice/detail?waybill\_number=OND132456A123

Result example

200 OK

```json { "id": "21", "username": "usernew1", "type": "ONMARKET CHECKOUT", "amount": 10000, "xendit_invoice": "658bee8b8013d711637b9a7b", "invoice": "OM0001N0CR0000f", "status": "PAID", "src": "XENDIT", "xendit_url": "https://checkout-staging.xendit.co/web/658bee8b8013d711637b9a7b", "expired_at": "2023-12-27T11:29:47.812Z", "createdAt": "2023-12-27T09:29:48.025Z", "updatedAt": "2023-12-27T09:30:00.052Z" } ```

Error example

400 Bad request

```json { "message": "Invoice not found" } ```

401 Unauthorized

```json { "message": "Auth Error" } ```

500 Internal server error

```json { "message": "Internal Error" } ```

# Invoice cancel ##### Endpoint

Endpoint	Method	Authentication
/invoice/cancel	POST	yes

##### Authentication

Type	Auth type
Basic	Login and password same as USAPI Login

##### Body request ```json { "platform": "ONMARKET", "invoice_id": "OM0003d0CS00009", "invoice_onmarket": "INV/ONM/20240124-002B0001", "buyer_username": "usernew1" } ```

Properties	Properties of	Data type	Required	Description
platform		string	yes	ONINDONESIA services. Possible values: - ONDELIVERY means the source of the transaction comes from ondelivery. - ONTICKET means the source of the transaction comes from onticket. - ONMARKET means the source of the transaction comes from onmarket.
invoice\_id		string	yes	invoice ID generated by USAPI
invoice\_onmarket		string	no¹	Invoice ID generated by ONMARKET ¹if status of the invoice is PAID, it will be refunded to buyer's balance from each store. So invoice\_onmarket is required.
buyer_username		string	no¹	Username from buyer ¹if status of the invoice is PAID, it will be refunded to buyer's balance. So buyer's username is required.

Result example

200 OK (Invoice status is PAID)

```json { "message": "REFUND IN PROCESS" } ```

200 OK (Invoice status is PENDING)

```json { "message": "INVOICE CANCELED" } ```

Error example

400 Bad request

```json { "message": "REFUND ALREADY IN PROCESS" } ``` ```json { "message": "TRANSACTION IS ALREADY CANCELED" } ``` ```json { "message": "EXPIRED INVOICE" } ```

500 Internal server error

```json { "message": "INTERNAL SERVER ERROR" } ```

# Invoice done/completed ##### Update log: April 24th, 2024 Change Auth from Bearer to Basic ##### Endpoint

Endpoint	Method	Authentication
/invoice/done	POST	yes

##### Authentication

Type	Token source	Server
Basic	Login and password same as USAPI Login	USAPI

##### Body request ```json { "platform": "ONMARKET", "invoice_id": "OM0003d0CS00009", "invoice_onmarket": "INV/ONM/20240124-002B0001" } ```

Properties	Properties of	Data type	Required	Description
platform		string	yes	ONINDONESIA services. Possible values: - ONDELIVERY means the source of the transaction comes from ondelivery. - ONTICKET means the source of the transaction comes from onticket. - ONMARKET means the source of the transaction comes from onmarket.
invoice\_id		string	yes	invoice ID generated by USAPI
invoice\_onmarket		string	no¹	Invoice ID generated by ONMARKET ¹if status of the invoice is PAID, it will be refunded to buyer's balance from each store. So invoice\_onmarket is required.

Result example

200 OK (Invoice status is PAID)

```json { "message": "TRANSACTION IS COMPLETED" } ```

Error example

400 Bad request

```json { "message": "REFUND ALREADY IN PROCESS" } ``` ```json { "message": "TRANSACTION IS ALREADY CANCELED" } ``` ```json { "message": "EXPIRED INVOICE" } ``` ```json { "message": "TRANSACTION IS ALREADY COMPLETED" } ```

500 Internal server error

```json { "message": "INTERNAL SERVER ERROR" } ```

# Balance Balance related process including get, increment and decrement. # Get balance ##### Endpoint

Endpoint	Method	Authentication
/balance	GET	yes

##### Authentication

Type	Token source	Server
Bearer	{{USAPI}}/auth	usapi.onindonesia.id demousapi.onindonesia.id

#####

Result example

200 OK

```json { "balance": 40000 } ```

Error example

401 Unauthorized

```json { "message": "Auth Error" } ```

# Bank List ##### Endpoint

Endpoint	Method	Authentication
/bank/list	POST	no

##### Authentication

Type	Token source	Server
none

##### Body request ```json { "bank_name": , "channel_type": } ```

Properties	Properties of	Data type	Required	Description
bank\_name		string	yes	Name of the bank
channel\_type		string	yes	Bank channel type. Available types: 1. Bank 2. E-Wallet

Result example

200 (OK)

```javascript [ { "id": 22, "bank_channel": "ID_BOC", "description": "Bank of China (BOC)", "type": "Bank", "currency": "IDR", "alias": null } ] ```

Error example

Body request example

```javascript insert code here ```

Type	Token source	Server
none