Wallet & Payment (SNAP)

Introduction

Definition of Wallet & Payment

YUKK Wallet & Payment API allows Partners to integrate YUKK Wallet into their platform. This service enables users to link their YUKK account, access wallet information, and perform wallet transactions such as payments, transfers, top-ups, and refunds.

Purpose of the Integration

The primary purpose of this integration is to enable users to securely link their YUKK account to your platform and access YUKK Wallet features directly from your application. After account binding, users can:

View Balance: Retrieve the user's YUKK wallet balance.
View Transaction History: Access transaction history and details.
Top Up Wallet: Add funds to the user's YUKK wallet.
Transfer Funds: Transfer funds to another YUKK account or a bank account.
Pay with YUKK Wallet: Make payments using the user's YUKK wallet balance.
Cancel or Refund Transactions: Cancel or refund eligible wallet transactions.

YUKK Wallet & Payment API allows API integration to access user's YUKK wallet information and make payment using Yukk balance through your platform.

Use this collection if you have users who have account in Yukk and are willing to bind their account to your platform. Upon account binding, user is able to access the following features in your platform:

See Yukk balance
See transaction history / detail
Top Up Yukk Cash
Transfer to Yukk or to Bank
Pay using Yukk Cash
Cancel / Refund the transaction

Base URL

YUKK Wallet & Payment provides two distinct environments to support a secure development lifecycle: Staging for testing and Production for live transactions. Please ensure that you use the correct Base URL for your current integration environment, as some API endpoints are available only in Staging or Production.

note

💡 YUKK Wallet & Payment Staging Base URL
sandbox.yukk.co

note

💡 YUKK Wallet & Payment Production Base URL
api.yukk.co

Authentication for YUKK Wallet

To ensure secure and authorized access, YUKK utilizes digital signatures to validate every API request. These signatures are divided into two types based on their request function:

note

Used to secure the initial client credential exchange process to obtain a B2B Access Token. This digital signature is generated using your private key and validated by YUKK using your registered public key.

🔗 Visit our Asymmetric Signature Guide ↗

note

Used to sign and access all API services. This digital signature secures your payloads by hashing transaction data using your client secret and active access token.

🔗 Visit our Symmetric Signature Guide ↗

Access Token B2B

POST Get Access Token (B2B)
This API is used by the Partner's backend server to obtain a secure B2B-level Access Token. Unlike the B2B2C token (which is bound to a specific user's consent), this B2B token is based on client_credentials with a specific "wallet.connect" scope to authorize overall server-to-server operations.

note

🌐 This API to get access token as B2B
https://sandbox.yukk.co/auth/openapi/v1.0/access-token/b2b

Specification Request

API Name	API Access Token B2B
Function	to obtain `accessToken` (B2B token), which should be included in Authorization Bearer of all Wallet & Payment API Collection.
Service Code	73
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	…/{version}/access-token/b2b

Authorization
This API uses Bearer Token authentication. Before calling this endpoint, generate a B2B Access Token using the B2B Token API. Then, configure the Authorization tab in your API client by selecting Bearer Token as the authentication type and provide the generated B2B Access Token.

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	M	Value always: `application/json`.
X-TIMESTAMP	String	M	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	M	Asymmetric signature generated using your Private Key (RSA-2048). Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-DEVICE-ID	String	M	User hardware/software agent identification (e.g., insomnia/8.5.1).
CHANNEL-ID	String	M	Value always: `00002`.
X-CLIENT-KEY	String	M	Your unique integration Client ID (Client Key).

Request Body
The following table is a body of request parameter:

Field	Type	Attributes	Description
grantType	String	M	Value always: `client_credentials`. Example: client_credentials
additionalInfo	Object	O	Container representing extra authorization parameters. Example:
additionalInfo.scope	String	M	Specify target authorization boundary. Value always: `wallet.connect`. Example: wallet.connect

Body raw (json)

{
    "grantType": "client_credentials",
    "additionalInfo": {
        "scope": "wallet.connect"
    }
}

Sample Request

200 OK Successful

//200 OK Succesful
curl --location 'https://sandbox.yukk.co/auth/openapi/v1.0/access-token/b2b' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: aO7oes59e8P2kp+knwb8rfk9CyGDhRAi4p7YNYqF4Gh72Zrzc52SfdoWgVlvcXlYqHONu+8WADIJhht5G5si0gHEI9QsDTy6RuIMIF4SY7NNh+N7Sr6oUvoyDrzskSnO6G82Ns5Co9mMSEcgNtdYsW6pOjXmLCEq6voDK7esxJg/z8TBFBMAfr5jXYi48IkZHkJPYJ/uJ721q9ld3KHDDN3TbAZlysxEiFcvcc71wu+PcU00qGApBK7LrAUbRkduMhVo4k6TaXUh3cJfGi8U/S5Ap/fWnR97p+jbLLjU0+ASDSM/DBz2Go9inZnoQYnKSXXNbDz812Cm1Y5w2FkYBA==' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.3) AppleWebKit/533.1.1 (KHTML, like Gecko) Chrome/14.0.869.0 Safari/533.1.1' \
--header 'CHANNEL-ID: 00002' \
--header 'X-CLIENT-KEY: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--data '{
    "grantType": "client_credentials",
    "additionalInfo": {
        "scope": "wallet.connect"
    }
}'

401 Unauthorized Unknown Client

//401 Unauthorized Unknown Client
curl --location 'https://sandbox.yukk.co/auth/openapi/v1.0/access-token/b2b' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: aO7oes59e8P2kp+knwb8rfk9CyGDhRAi4p7YNYqF4Gh72Zrzc52SfdoWgVlvcXlYqHONu+8WADIJhht5G5si0gHEI9QsDTy6RuIMIF4SY7NNh+N7Sr6oUvoyDrzskSnO6G82Ns5Co9mMSEcgNtdYsW6pOjXmLCEq6voDK7esxJg/z8TBFBMAfr5jXYi48IkZHkJPYJ/uJ721q9ld3KHDDN3TbAZlysxEiFcvcc71wu+PcU00qGApBK7LrAUbRkduMhVo4k6TaXUh3cJfGi8U/S5Ap/fWnR97p+jbLLjU0+ASDSM/DBz2Go9inZnoQYnKSXXNbDz812Cm1Y5w2FkYBA==' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.3) AppleWebKit/534.1.2 (KHTML, like Gecko) Chrome/20.0.800.0 Safari/534.1.2' \
--header 'CHANNEL-ID: 00002' \
--header 'X-CLIENT-KEY: somerandomclient' \
--data '{
    "grantType": "client_credentials",
    "additionalInfo": {
        "scope": "wallet.connect"
    }
}
'

401 Unauthorized Invalid Signature

//401 Unauthorized Invalid Signature
curl --location 'https://sandbox.yukk.co/auth/openapi/v1.0/access-token/b2b' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: aO7oes59e8P2kp+knwb8rfk9CyGDhRAi4p7YNYqF4Gh72Zrzc52SfdoWgVlvcXlYqHONu+8WADIJhht5G5si0gHEI9QsDTy6RuIMIF4SY7NNh+N7Sr6oUvoyDrzskSnO6G82Ns5Co9mMSEcgNtdYsW6pOjXmLCEq6voDK7esxJg/z8TBFBMAfr5jXYi48IkZHkJPYJ/uJ721q9ld3KHDDN3TbAZlysxEiFcvcc71wu+PcU00qGApBK7LrAUbRkduMhVo4k6TaXUh3cJfGi8U/S5Ap/fWnR97p+jbLLjU0+ASDSM/DBz2Go9inZnoQYnKSXXNbDz812Cm1Y5w2FkYBA==' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; U; PPC Mac OS X 10.8.5; rv:8.2) Gecko/20100101 Firefox/8.2.4' \
--header 'CHANNEL-ID: 00002' \
--header 'X-CLIENT-KEY: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--data '{
    "grantType": "client_credentials",
    "additionalInfo": {
        "scope": "yukk.payment-gateway"
    }
}
'

400 Bad Request No Additional Info Provided

//400 Bad Request No Additional Info Provided
curl --location 'https://sandbox.yukk.co/auth/openapi/v1.0/access-token/b2b' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: aO7oes59e8P2kp+knwb8rfk9CyGDhRAi4p7YNYqF4Gh72Zrzc52SfdoWgVlvcXlYqHONu+8WADIJhht5G5si0gHEI9QsDTy6RuIMIF4SY7NNh+N7Sr6oUvoyDrzskSnO6G82Ns5Co9mMSEcgNtdYsW6pOjXmLCEq6voDK7esxJg/z8TBFBMAfr5jXYi48IkZHkJPYJ/uJ721q9ld3KHDDN3TbAZlysxEiFcvcc71wu+PcU00qGApBK7LrAUbRkduMhVo4k6TaXUh3cJfGi8U/S5Ap/fWnR97p+jbLLjU0+ASDSM/DBz2Go9inZnoQYnKSXXNbDz812Cm1Y5w2FkYBA==' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.2; Trident/7.0; rv:11.0) like Gecko' \
--header 'CHANNEL-ID: 00002' \
--header 'X-CLIENT-KEY: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--data '{
    "grantType": "client_credentials"
}
'

400 Bad Request No Scope Provided

//400 Bad Request No Scope Provided
curl --location 'https://sandbox.yukk.co/auth/openapi/v1.0/access-token/b2b' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: aO7oes59e8P2kp+knwb8rfk9CyGDhRAi4p7YNYqF4Gh72Zrzc52SfdoWgVlvcXlYqHONu+8WADIJhht5G5si0gHEI9QsDTy6RuIMIF4SY7NNh+N7Sr6oUvoyDrzskSnO6G82Ns5Co9mMSEcgNtdYsW6pOjXmLCEq6voDK7esxJg/z8TBFBMAfr5jXYi48IkZHkJPYJ/uJ721q9ld3KHDDN3TbAZlysxEiFcvcc71wu+PcU00qGApBK7LrAUbRkduMhVo4k6TaXUh3cJfGi8U/S5Ap/fWnR97p+jbLLjU0+ASDSM/DBz2Go9inZnoQYnKSXXNbDz812Cm1Y5w2FkYBA==' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_10_7 rv:3.0; KU) AppleWebKit/534.0.2 (KHTML, like Gecko) Version/5.1.1 Safari/534.0.2' \
--header 'CHANNEL-ID: 00002' \
--header 'X-CLIENT-KEY: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--data '{
    "grantType": "client_credentials",
    "additionalInfo": {
        "scope": null
    }
}
'

400 Bad Request No X-Signature Provided

//400 Bad Request No X-Signature Provided
curl --location 'https://sandbox.yukk.co/auth/openapi/v1.0/access-token/b2b' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.2) AppleWebKit/537.1.1 (KHTML, like Gecko) Chrome/16.0.830.0 Safari/537.1.1' \
--header 'CHANNEL-ID: 00002' \
--header 'X-CLIENT-KEY: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--data '{
    "grantType": "client_credentials",
    "additionalInfo": {
        "scope": "wallet.connect"
    }
}
'

Sample Response

200 OK Successful

Body
Header (11)

    //200 OK
    {
        "responseCode": "2007300",
        "responseMessage": "Successful",
        "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIwMTViZjgzNi1kNmFjLTRmNWUtYTc0NS1hODkxYjk1ZWRiNDYiLCJqdGkiOiJmNWVmNjBiYjlhOTE2NjU4NDFkMTMyYzMxNzRmNDllM2VhOTFjNDdmNWJkYTgxYWIxYzhkODE0NGQ2MGUxMjEyOWNmNGZjZDRlZTBlODYxZSIsImlhdCI6MTc3OTE5ODY0NC45OTU2NjksIm5iZiI6MTc3OTE5ODY0NC45OTU2NzMsImV4cCI6MTc3OTE5OTU0NC45NzQ1NjcsInN1YiI6IiIsInNjb3BlcyI6WyJ5dWtrLnBheW1lbnQtZ2F0ZXdheSJdfQ.sY40NwXV94GkwFjtyMn3cTqoLUNydgFai-_lVjtSDeMRrt1_4fIJdiWgUpuLPl667y02R6yY2SGYC-_sYOi3cfxE_YXE0qgCD-SX6agvmX0Ya-I7eTuNQ1x_2k0uXIRqhA8syNT5_GGgUEzm5FpmyZuQ1V_CqQd2kMxQOvyxmtD3M59Iub8qMLWZ2PpHrUK2ajUeyAIAT8h02bExCf3nhn1Ui_au1WYj9jrNNLayCP-rKLa7LOrtEJR_plaz3hZldp6EBYCnybG5hO1XlHgUrHJJKNPOlIQ3V_ydFzPli8w1Nts6D68DZ4Zh4Ybg-agvwas0Zth5nbMr0OYiW_y_qMcH_ITjzo21gTOHodcnMENl6oGodiLZzEdhzseWmmUVeuCEojDSBLifhLISETCboprX-3SwJF6PDNya7w1UwsCN1Y95ZgWhu-JFEeDbzj0Nvhi7Lh7O5_TYeaPiXCjp1cVDB2e9koRMjrUI9eWQhRadDLJM_K6Gim8UdC8WjKOd18yOUGIKmECsqb9BAurHNbrlOSrGv8Wykvkp3x8nn6HYSUITnWGq77kWuWYgqeeYPTbRheU8JYL04OiHfte2zm7v1WR3pN19e2sdVjaoPQCphUOy2-NR3BfMdyLhCmxn0UICjL0Qv32_EYrHA8rqUytMp06ciuCt0D-9Py_fD4I",
        "tokenType": "Bearer",
        "expiresIn": "900",
        "additionalInfo": {
            "scope": "wallet.connect"
        }
    }

401 Unauthorized Unknown Client

Body
Header (11)

    //401 Unauthorized Unknown Client
    {
        "responseCode": "4017300",
        "responseMessage": "Unauthorized. (Unknown Client)"
    }

401 Unauthorized Invalid Signature

Body
Header (11)

    //401 UNAUTHORIZED
    {
        "responseCode": "4017300",
        "responseMessage": "Unauthorized. (Invalid signature)"
    }

400 Bad Request No Additional Info Provided

Body
Header (10)

    //400 BAD REQUEST
    {
        "responseCode": "4007302",
        "responseMessage": "Invalid Mandatory Field (additionalInfo)"
    }

400 Bad Request No Scope Provided

Body
Header (10)

    //400 BAD REQUEST
    {
        "responseCode": "4007302",
        "responseMessage": "Invalid Mandatory Field (additionalInfo.scope)"
    }

400 Bad Request No X-Signature Provided

Body
Header (10)

    //400 BAD REQUEST
    {
        "responseCode": "4007302",
        "responseMessage": "Invalid Mandatory Field (X-SIGNATURE)"
    }

Account

This API collection enables Partners to manage the YUKK account registration and binding lifecycle, including account registration, OTP verification, account binding, and account unlinking.

Account Registration & Binding API Overview

To deliver a seamless embedded wallet experience, the Account Registration & Binding suite is divided into four core integration services:

Account Creation (H2H): Register a new YUKK user account directly from the Partner's backend.
OTP Service: Request and verify one-time passwords (OTP) for user verification.
Account Creation & Binding (Web): Allow users to register or sign in and securely bind their YUKK account through a hosted web interface.
Account Unbinding: Revoke user authorization and unlink the YUKK account from your platform.

Account Creation via API

This endpoint is used to register a new user through the Host-to-Host (H2H) integration. Upon successful registration, the user will be assigned a Premium YUKK Account with the following transaction and balance limits:

Maximum YUKK Cash Balance: IDR 20,000,000.
Maximum Monthly Transaction Limit: IDR 40,000,000 (combined monthly Cash In and Cash Out).

Process Flow

POST Account Creation

note

🌐 This API to Account Creation
https://sandbox.yukk.co/wallet/openapi/v1.0/registration-account-creation

Specification Request

API Name	API Account Creation
Function	To create new account YUKK
Service Code	06
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/registration-account-creation

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	(M)	Value always: `application/json`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.
User-Agent	String	(M)	Depend on library used

Request Body
The following table is a body of request parameter:

Field	Attributes	Type	Description
partnerReferenceNo	M	String (64)	Unique reference number generated by the partner (must be unique per day per partner).
customerId	O	String (45)	YUKK ID or User's account ID.
countryCode	M	String (8)	Value of country code e.g: `ID, EN,etc.`
name	C	String (128)	User's full name. Mandatory only if `customerId` is not used.
phoneNo	C	String (16)	User's phone number. Mandatory only if `customerId` is not used.
email	C	String (254)	User's email address. Mandatory only if `customerId` is not used.
gender	O	String (10)	User's gender. Value: `LAKI-LAKI` or `PEREMPUAN`. If not filled, default value is `LAKI-LAKI`.
scopes	C	String (256)	Account type scope. Value: `BASIC_USER` or `PREMIUM_USER`. Mandatory only if `customerId` is not used. If `customerId` is used, value should only be `PREMIUM_USER`.
additionalInfo	O	Object	Container for custom metadata.
ktpData	C	Object	National ID card verification container. Mandatory only if `scopes` is set to `PREMIUM_USER`.
nik	M	String (16)	National Identity Number (NIK) from KTP.
name	M	String (128)	Full name matching the KTP exactly.
address	M	String (512)	Full registered address matching the KTP.
placeOfBirth	M	String (128)	Place of birth matching the KTP.
dateOfBirth	M	String (10)	Date of birth matching the KTP (Format: `YYYY-MM-DD`).
gender	M	String (10)	Value: `LAKI-LAKI` or `PEREMPUAN`.
maritalStatus	M	String (20)	Value: `KAWIN` or `BELUM KAWIN`.
job	M	String (50)	Occupation matching the KTP.
nationality	M	String (20)	Nationality matching the KTP.
photoKtp	M	Base64	Base64 encoded string of the KTP photo.
photoSelfie	M	Base64	Base64 encoded string of the user's selfie.
photoSelfieWithKtp	O	Base64	Base64 encoded string of the user's selfie holding their KTP.
ktpData.ktpVerification	C	Object	Mandatory only if `scopes = PREMIUM_USER` & KTP Verification is skipped.
provider	M	String (20)	Provider for KTP verification. Value: `VERIHUBS`.
successPayload	M	String (512)	Success response verification payload in JSON format.

Bodyraw(json)

{
    "partnerReferenceNo": "TEST-YUKK-QA-202406110001",
    "countryCode": "ID",
    "name":"Darryl Gottlieb III",
    "gender": "LAKI-LAKI",
    "phoneNo": "6281234500007",
    "email": "Ruben_Terra@yahoo.com",
    "scopes": "BASIC_USER"
}

Sample Request

200 OK Successful Account Creation

//200 OK Successful Account Creation
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/registration-account-creation' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2025-02-25T15:25:31+07:00' \
--header 'X-SIGNATURE: vp74/K7mrRVLjOEDB/sNRXpSQoGCeXjeUWaFC2MkJTLv+vyQzf6jCEPS3H7sxbpC+XkdOgzuJUNlA8xABCDEf==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: Jvylp8cdwOC1Yhf' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 5.3; rv:6.7) Gecko/20100101 Firefox/6.7.3' \
--header 'CHANNEL-ID: 0002' \
--header 'User-Agent: insomnia/8.5.1' \

200 OK Premium Account Upgrade

//200 OK Premium Account Upgrade
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/registration-account-creation' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2025-02-25T15:25:31+07:00' \
--header 'X-SIGNATURE: vp74/K7mrRVLjOEDB/sNRXpSQoGCeXjeUWaFC2MkJTLv+vyQzf6jCEPS3H7sxbpC+XkdOgzuJUNlA8xABCDEf==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: gfWvNt0UZ2Xk4HP' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4 rv:2.0; LT) AppleWebKit/538.1.0 (KHTML, like Gecko) Version/4.1.9 Safari/538.1.0' \
--header 'CHANNEL-ID: 0002' \
--header 'User-Agent: insomnia/8.5.1' \

Sample Response

200 OK Successful Account Creation

Body
Header (10)

    //200 OK
        {
          "responseCode": "2000600",
          "responseMessage": "Successful",
          "referenceNo": "ACR-202406121008202435",
          "partnerReferenceNo": "TEST-YUKK-QA-202406120001",
          "accountId": "kuna21",
          "temporary_external_id": "9OamhmoiZGWQY79",
          "additionalInfo": {
            "userStatus": "PENDING"
          }
        }

200 OK Premium Account Upgrade

Body
Header (10)

    //200 OK
    {
    "responseCode": "2000600",
    "responseMessage": "Successful",
    "referenceNo": "ACR-202605211406181276",
    "partnerReferenceNo": "yourcustomvalue-02",
    "accountId": "indra69",
    "temporary_external_id": "vu_2yGw9nielUae",
    "additionalInfo": {
        "userStatus": "PENDING"
    }
    }

OTP Service

The OTP Service is a two-step verification mechanism required to validate user identity during H2H account creation.

POST Send OTP
This endpoint is used by the Partner to trigger and send a secure 6-digit OTP code directly to the user's mobile phone.

note

🌐 This API to send OTP
https://sandbox.yukk.co/wallet/openapi/v1.0/otp

Specification Request

API Name	API OTP
Function	Use API to send OTP directly to user
Service Code	81
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/otp

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	M	Value always: `application/json`.
Authorization-Customer	String	M	Customer-level authorization token format: `Bearer <token>`.
X-TIMESTAMP	String	M	Client's current local time in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	M	Digital signature for payload validation.
X-PARTNER-ID	String	M	Unique Partner Client ID
X-EXTERNAL-ID	String	M	Unique transaction reference string (e.g., f7wamAXVvTMZzos).
X-DEVICE-ID	String	M	User agent or unique hardware device ID.
CHANNEL-ID	String	M	Value always: `00002`.
User-Agent	String	M	Depend on library used

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
journeyID	String (32)	M	Unique identifier for the user session. On the first request, this must match the `X-EXTERNAL-ID` of the Account Creation API. For subsequent requests, use the returned `chargeToken`.
additionalInfo	Object	O	Container for custom metadata.
provider	String (10)	O	The delivery channel. Default value: `mail`.

Bodyraw(json)

{
    "journeyID": "wqc3_zkst10ruPn",
    "additionalInfo": {
        "provider": "mail"
    }
}

Sample Request

200 OK

//200 OK 
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/otp' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2025-02-25T15:25:31+07:00' \
--header 'X-SIGNATURE: vp74/K7mrRVLjOEDB/sNRXpSQoGCeXjeUWaFC2MkJTLv+vyQzf6jCEPS3H7sxbpC+XkdOgzuJUNlA8xABCDEf==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: 7scK9oQ5GUT9sJR' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_5_3 rv:4.0; AR) AppleWebKit/534.0.2 (KHTML, like Gecko) Version/5.0.7 Safari/534.0.2' \
--header 'CHANNEL-ID: 0002' \
--header 'User-Agent: insomnia/8.5.1' \
--data '{
    "journeyID": "G0hoXaBCx9nuNwz"
}'

404 JourneyID Not Found

//404 JourneyID Not Found
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/otp' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2025-02-25T15:25:31+07:00' \
--header 'X-SIGNATURE: vp74/K7mrRVLjOEDB/sNRXpSQoGCeXjeUWaFC2MkJTLv+vyQzf6jCEPS3H7sxbpC+XkdOgzuJUNlA8xABCDEf==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: 78btomH7EUfbTmw' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 5.0; Win64; x64; rv:6.3) Gecko/20100101 Firefox/6.3.5' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "journeyID": "t1zA5tBSR6CIGd",
    "additionalInfo": {
        "provider": "mail"
    }
}'

Sample Response

200 OK

Body
Header (10)

    //200 OK 
    {
    "responseCode": "2008100",
    "responseMessage": "Successful",
    "chargeToken": "OTP-202605211438402960"
    }

404 Not Found

Body
Header (10)

    //404 NOT FOUND
    {
    "responseCode": "4048107",
    "responseMessage": "The JourneyID cannot be fond in the system."
    }

Verify OTP

POST Verify OTP
This endpoint is used by the Partner to validate the 6-digit OTP code inputted by the user.

note

🌐 This API to verify OTP
https://sandbox.yukk.co/wallet/openapi/v1.0/otp-verification

Specification Request

API Name	API to Verify OTP
Function	Use this API to verify the OTP inputted by user.
Service Code	04
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	…/{version}/otp-verification

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	M	Value always: `application/json`.
Authorization-Customer	String	M	Customer-level authorization token format: `Bearer <token>`.
X-TIMESTAMP	String	M	Client's current local time in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	M	Digital signature for payload validation.
X-PARTNER-ID	String	M	Unique Partner Client ID
X-EXTERNAL-ID	String	M	Unique transaction reference string (e.g., f7wamAXVvTMZzos).
X-DEVICE-ID	String	M	User agent or unique hardware device ID.
CHANNEL-ID	String	M	Value: 0002
User-Agent	String	M	Depend on library used

Request Body
The following table is a body of request parameter:

Field	Type	Attributes	Description
otp	String (6)	M	The 6-digit validation code entered by the user (e.g., `515064`).
chargeToken	String	M	Unique token representing the active OTP transaction session.
action	String	M	The transaction intent (e.g., `REGIST`).
additionalInfo	Object	M	Container representing additional callback configurations.
redirectUrl	String (256)	M	Callback redirection URL after successful verification process (e.g., `https://testingyukk.proxy.beeceptor.com`)

Bodyraw(json)

{
    "otp": "515064",
    "chargeToken": "OTP-202605211525216791",
    "action": "REGIST",
    "additionalInfo":{
        "redirectUrl":"https://testingyukk.proxy.beeceptor.com"
    }
}

Sample Request

200 OK

//200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/otp-verification' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2025-02-25T15:25:31+07:00' \
--header 'X-SIGNATURE: vp74/K7mrRVLjOEDB/sNRXpSQoGCeXjeUWaFC2MkJTLv+vyQzf6jCEPS3H7sxbpC+XkdOgzuJUNlA8xABCDEf==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: bP_dBQgLUWvXLLb' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.2; Trident/7.0; rv:11.0) like Gecko' \
--header 'CHANNEL-ID: 00002' \
--header 'User-Agent: insomnia/8.5.1' \
--data '{
    "otp": "515064",
    "chargeToken": "OTP-202605211525216791",
    "action": "REGIST",
    "additionalInfo":{
        "redirectUrl":"https://testingyukk.proxy.beeceptor.com"
    }
}'

404 Incorrect OTP

//404 Incorrect OTP
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/otp-verification' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2025-02-25T15:25:31+07:00' \
--header 'X-SIGNATURE: vp74/K7mrRVLjOEDB/sNRXpSQoGCeXjeUWaFC2MkJTLv+vyQzf6jCEPS3H7sxbpC+XkdOgzuJUNlA8xABCDEf==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: NdtfNAqgBfzI6ZB' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 5.3) AppleWebKit/533.1.0 (KHTML, like Gecko) Chrome/15.0.858.0 Safari/533.1.0' \
--header 'CHANNEL-ID: 00002' \
--header 'User-Agent: insomnia/8.5.1' \
--data '{
    "otp": "515064",
    "chargeToken": "OTP-202605211525216791",
    "action": "REGIST",
    "additionalInfo":{
        "redirectUrl":"https://testingyukk.proxy.beeceptor.com"
    }
}'

Sample Response

200 OK

Body
Header (10)

    //200 OK 
    {
    "responseCode": "2000400",
    "responseMessage": "Successful",
    "additionalInfo": {
        "webviewUrl": "http://wallet.yukk.local/auth?ref_id=7bb9a1d552fe01956fc17381d03b70bb3b0be3afe39b857300370f8b72bc6bdc"
    }
    }

404 NOT FOUND

Body
Header (10)

    //404 NOT FOUND
    {
    "responseCode": "4040415",
    "responseMessage": "OTP is incorrect."
    }

Webhook Notify User Status

This API sends real-time webhook notifications to the Partner's registered Webhook URL whenever a user's account verification or Premium Upgrade status is updated. The Webhook URL must be registered with the YUKK Activation Team before use. User Status Outcomes:

REGISTERED → User successfully passed KYC verification and was upgraded to a Premium account.
REJECTED → User failed KYC verification and remains a Basic account.

Specification Request

API Name	Webhook User Status Notify
Function	Account manager will receive the notification status of registered
HTTP Method	POST

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	M	Value always: `application/json`.
Signature	String	M	Hashing digital signature to verify request authenticity and ensure payload integrity from YUKK. Formula: SHA512(client_secret + partnerReferenceNo + accountId)

Response Body
The following table is a body of response parameter:

Field	Type	Attributes	Description
responseCode	String (7)	M	Standardized status code. Value always: `2007400`.
responseMessage	String (150)	M	Descriptive message. Value always: `Successful`.
partnerReferenceNo	String (64)	M	Original reference number provided by the partner.
accountId	String (32)	M	Unique YUKK Account ID belonging to the user.
userStatus	String (20)	M	Review status outcome. Value: `REGISTERED` or `REJECTED`.

Account Creation & Binding via WEB

If Partners prefer not to handle the native H2H registration flow, they can redirect users to YUKK's secure, hosted Webview. This allows users to either register as a new user or sign in with their existing YUKK account manually.

Process Flow

GET Account Binding (Get OAuth URL)
This API is used to register your redirect URL and generate a secure, tokenized URL to launch the hosted YUKK Webview binding screen for the customer.

note

🌐 This API to Get Account Binding
https://sandbox.yukk.co/auth/api/v1.0/get-auth-code?state=BX66HVOwsltcGy0&scopes=wallet.connect&redirectUrl=https://testingyukk.proxy.beeceptor.com&partnerId=&timestamp=2024-05-19T09:45:00+07:00&externalId=maSGg_J3Pz13l2Z&channelId=00002&seamlessData={"mobileNumber"%3A"6289668058996"}&seamlessSign=M52rWFBrSBkUPUIwDR5x4UrJZ6vqarnK57T4YnQ4VBx0RIT9gLr%2FVist01bmT125vjvvgKC8e3iizafRUdMQrcl9VZMtQL5U32EfUKeO6RJt6tsNvKKLl17iax6%2F15%2BSvQ9E3zo0yP0sVrFcBkYC7kpSrc0R9P3UcAwNslelp5Vy29YhIVkGFaeyvElQm2zE4TJ3Ec9sxCshPs5%2BaB6rMxdW6pN1%2FwOpKg0GjSY%2FLMDuj8vnZKqSNnWZZjnrbaFsJ6T9aZ5Fuiou%2FrsNZrb%2FYo%2FwEBJLlDYfaiSI%2FNKrJmUIr%2F0CAnFiN5YGAzjY1t6PJRWQ6C7%2Fjz49UIAVuydi5Q%3D%3D

Flow Process
After hit this API, you will be redirected to YUKK's secure connection portal:

note

https://sandbox.yukk.co/auth/api/v1.0/get-auth-code?state=SPOH1jXs9iMJuRZ&scopes=wallet.connect&redirectUrl=https://testingyukk.proxy.beeceptor.com&partnerId=&timestamp=2024-05-19T09:45:00+07:00&externalId=mFjymwgu5XnaFQ2&channelId=00002&seamlessData=%7B%22mobileNumber%22%3A%226289668058996%22%7D&seamlessSign=M52rWFBrSBkUPUIwDR5x4UrJZ6vqarnK57T4YnQ4VBx0RIT9gLr%2FVist01bmT125vjvvgKC8e3iizafRUdMQrcl9VZMtQL5U32EfUKeO6RJt6tsNvKKLl17iax6%2F15%2BSvQ9E3zo0yP0sVrFcBkYC7kpSrc0R9P3UcAwNslelp5Vy29YhIVkGFaeyvElQm2zE4TJ3Ec9sxCshPs5%2BaB6rMxdW6pN1%2FwOpKg0GjSY%2FLMDuj8vnZKqSNnWZZjnrbaFsJ6T9aZ5Fuiou%2FrsNZrb%2FYo%2FwEBJLlDYfaiSI%2FNKrJmUIr%2F0CAnFiN5YGAzjY1t6PJRWQ6C7%2Fjz49UIAVuydi5Q%3D%3D

Upon successful authentication and account binding, YUKK will redirect back to your registered redirectUrl with the following dynamic query parameters appended to the URL:
responseCode=2001000&responseMessage=Auth+code+has+been+successfully+granted.&authCode={{authCode}}

Specification Request
Use this API to register your redirect URL upon successful binding, and display Yukk WebApp binding page to user.

API Name	API Get OAuth URL
Function	to register your redirect URL upon successful binding, and display Yukk WebApp binding page to user.
Service Code	10
Version	1.0
HTTP Method	GET
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/get-auth-code

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	M	Value always: `application/json`.
User-Agent	String	M	Depend on library used

Request Body
The following table is a body of request parameter:

Field	Attributes MOC	Type	Description
state	M	String (32)	Random string for CSRF security purpose
scopes	M	String (128)	Scope access from the selected authorization Format: comma-separated-value
redirectUrl	M	String (512)	Callback URL after successful getAuthCode process
partnerId	M	String (64)	partnerId
timestamp	M	String (128)	Current timestamp
externalId	M	String (128)	Unique external ID
channelId	M	String (32)	Channel ID = `"00002"`
seamlessData	M	String (512)	seamlessData = `URLEncode({"mobileNumber" = "62xx"})`
seamlessSign	M	String (512)	seamlessSign = `URLEncode(sign(seamlessData))`

Request Sample

//200 OK
curl --location 'https://sandbox.yukk.co/auth/api/v1.0/get-auth-code?state=DcQj528BMkHrNVd&scopes=wallet.connect&redirectUrl=https%3A%2F%2Ftestingyukk.proxy.beeceptor.com&partnerId=&timestamp=2024-05-19T09%3A45%3A00%2B07%3A00&externalId=w6hcXjO2Kd0KPzl&channelId=00002&seamlessData=%257B%2522mobileNumber%2522%253A%25226289668058996%2522%257D&seamlessSign=M52rWFBrSBkUPUIwDR5x4UrJZ6vqarnK57T4YnQ4VBx0RIT9gLr%252FVist01bmT125vjvvgKC8e3iizafRUdMQrcl9VZMtQL5U32EfUKeO6RJt6tsNvKKLl17iax6%252F15%252BSvQ9E3zo0yP0sVrFcBkYC7kpSrc0R9P3UcAwNslelp5Vy29YhIVkGFaeyvElQm2zE4TJ3Ec9sxCshPs5%252BaB6rMxdW6pN1%252FwOpKg0GjSY%252FLMDuj8vnZKqSNnWZZjnrbaFsJ6T9aZ5Fuiou%252FrsNZrb%252FYo%252FwEBJLlDYfaiSI%252FNKrJmUIr%252F0CAnFiN5YGAzjY1t6PJRWQ6C7%252Fjz49UIAVuydi5Q%253D%253D' \
--header 'Content-Type: application/json' \
--header 'User-Agent: insomnia/8.5.1'

Response Sample

Body
Header (11)

//200 OK
{
    "responseCode": "2001000",
    "responseMessage": "Successful",
    "state": "vjNHi5iVS88o8yf",
    "nextAction": "https://sandbox.yukk.co/auth/connect?partnerId=0c2f7714-6a61-4cef-b642-da5bf0d0c6d1&redirectUrl=https%3A%2F%2Ftestingyukk.proxy.beeceptor.com&state=vjNHi5iVS88o8yf&externalId=HUfWbeQWOlJgeZP&scopes=wallet.connect&timestamp=2024-05-19T09%3A45%3A00%2007%3A00&channelId=00002&seamlessData=%7B%22mobileNumber%22%3A%226289668058996%22%7D&seamlessSign=M52rWFBrSBkUPUIwDR5x4UrJZ6vqarnK57T4YnQ4VBx0RIT9gLr%2FVist01bmT125vjvvgKC8e3iizafRUdMQrcl9VZMtQL5U32EfUKeO6RJt6tsNvKKLl17iax6%2F15%2BSvQ9E3zo0yP0sVrFcBkYC7kpSrc0R9P3UcAwNslelp5Vy29YhIVkGFaeyvElQm2zE4TJ3Ec9sxCshPs5%2BaB6rMxdW6pN1%2FwOpKg0GjSY%2FLMDuj8vnZKqSNnWZZjnrbaFsJ6T9aZ5Fuiou%2FrsNZrb%2FYo%2FwEBJLlDYfaiSI%2FNKrJmUIr%2F0CAnFiN5YGAzjY1t6PJRWQ6C7%2Fjz49UIAVuydi5Q%3D%3D"
}

POST Get Access Token (B2B2C)
This API is used once you have successfully received the one-time authCode to obtain the permanent user-specific B2B2C accessToken and refreshToken required to authorize all subsequent customer-level wallet balance, history, and payment APIs.

note

🌐 This API to verify OTP
https://sandbox.yukk.co/auth/openapi/v1.0/access-token/b2b2c

Specification Request

API Name	API Access Token B2B2C
Function	to obtain `accessToken` (B2B2C token) once you have obtained `authCode` from callback response API Get OAuth URL
Service Code	74
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/access-token/b2b2c

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	M	Value always: `application/json`.
X-TIMESTAMP	String	M	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	M	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String	M	Unique integration Client ID
X-EXTERNAL-ID	String	M	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String	M	User hardware/software agent identification.
CHANNEL-ID	String	M	Value always: `00002`.
X-CLIENT-KEY	String	M	Your unique integration Client ID.

Request Body
The following table is a body of request parameter:

Field	Type	Attributes	Description
grantType	String	M	Specify the token request flow. Accepted values: `AUTHORIZATION_CODE` or `REFRESH_TOKEN`. Example: AUTHORIZATION_CODE
authCode	String (256)	C	The one-time authorization code received from the Webview callback redirect. Mandatory if grantType is `AUTHORIZATION_CODE`. Example: a3921b51340c56f6724eb14ed929ed5034cc93704fc9acc73efd49aadaefaf4f
refreshToken	String (512)	C	Token used to renew expired B2B2C access tokens without user re-authentication. Mandatory if grantType is `REFRESH_TOKEN`. Example: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...

Body raw (json)

{
    "grantType": "AUTHORIZATION_CODE",
    "authCode": "a3921b51340c56f6724eb14ed929ed5034cc93704fc9acc73efd49aadaefaf4f"
}

Sample Request

200 OK Successful Auth Code

//200 OK Successful Auth Code
curl --location 'https://sandbox.yukk.co/auth/openapi/v1.0/access-token/b2b2c' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: aO7oes59e8P2kp+knwb8rfk9CyGDhRAi4p7YNYqF4Gh72Zrzc52SfdoWgVlvcXlYqHONu+8WADIJhht5G5si0gHEI9QsDTy6RuIMIF4SY7NNh+N7Sr6oUvoyDrzskSnO6G82Ns5Co9mMSEcgNtdYsW6pOjXmLCEq6voDK7esxJg/z8TBFBMAfr5jXYi48IkZHkJPYJ/uJ721q9ld3KHDDN3TbAZlysxEiFcvcc71wu+PcU00qGApBK7LrAUbRkduMhVo4k6TaXUh3cJfGi8U/S5Ap/fWnR97p+jbLLjU0+ASDSM/DBz2Go9inZnoQYnKSXXNbDz812Cm1Y5w2FkYBA==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: RQ5PNkVPjVDcEuB' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 5.3) AppleWebKit/533.2.0 (KHTML, like Gecko) Chrome/23.0.886.0 Safari/533.2.0' \
--header 'CHANNEL-ID: 00002' \
--header 'X-CLIENT-KEY: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--data '{
    "grantType": "AUTHORIZATION_CODE",
    "authCode": "ccc7cf6c087fead2e53aeef22469b69bc2a00b87e07d8f0d5841322a9e05b457"
}'

200 OK Successful Refresh Token

//200 OK Successful Refresh Token
curl --location 'https://sandbox.yukk.co/auth/openapi/v1.0/access-token/b2b2c' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: aO7oes59e8P2kp+knwb8rfk9CyGDhRAi4p7YNYqF4Gh72Zrzc52SfdoWgVlvcXlYqHONu+8WADIJhht5G5si0gHEI9QsDTy6RuIMIF4SY7NNh+N7Sr6oUvoyDrzskSnO6G82Ns5Co9mMSEcgNtdYsW6pOjXmLCEq6voDK7esxJg/z8TBFBMAfr5jXYi48IkZHkJPYJ/uJ721q9ld3KHDDN3TbAZlysxEiFcvcc71wu+PcU00qGApBK7LrAUbRkduMhVo4k6TaXUh3cJfGi8U/S5Ap/fWnR97p+jbLLjU0+ASDSM/DBz2Go9inZnoQYnKSXXNbDz812Cm1Y5w2FkYBA==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: Yzv6vQjNL_pHpLg' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_5_6 rv:2.0; FJ) AppleWebKit/535.2.2 (KHTML, like Gecko) Version/4.0.9 Safari/535.2.2' \
--header 'CHANNEL-ID: 00002' \
--header 'X-CLIENT-KEY: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--data '{
    "grantType": "REFRESH_TOKEN",
    "refreshToken": "def502003c97863bcbe273afd4cffabda58dc5de14b57b49eecfe6457f11806eaa88b00d3878c85656fd21832857f4dcc5cbe11b85c9aa5217a67c425795afc5c1b3562f6d0307a944a8cc910e549a6d4504dd95c0951e7320342097f94c1b51358084173d5db0770cf671cbb230372407db612a424670bbb1acdf7b485ee6be483d67fa1fc3aadb7119de75f9ee37e4eaf6730980e7f8f05b7b1656501f056b5bb48d0ee0cfd3103e8dc2243234273f5f3b094d94972345b8aef29e764daa7d7cfc031bca489580e1a2aae350a9af30a29582390247f983f5822e165dd292614693ca5cf47ffc2f2181f4c0a17666227908e235570bb6140742e4f0207c5ebffc971b62f2d54598a86e184fbf474c06efbdff4a99b84f8d622f21ebf1e4ed60991653e371601687b1c1dd1194a38ba8c240230536b366717f8a05e86078a20587e9174c24657fdde98260a3fdc1ab13826b1f20c6a06afaac5efdd0b01f706c5db9c93e181a19b18eea439ee14a48b8677dbe05246b939e47b9e82308905cff8909075153a0b3e475"
}'

400 Invalid Auth Code

//400 Invalid Auth Code
curl --location 'https://sandbox.yukk.co/auth/openapi/v1.0/access-token/b2b2c' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: aO7oes59e8P2kp+knwb8rfk9CyGDhRAi4p7YNYqF4Gh72Zrzc52SfdoWgVlvcXlYqHONu+8WADIJhht5G5si0gHEI9QsDTy6RuIMIF4SY7NNh+N7Sr6oUvoyDrzskSnO6G82Ns5Co9mMSEcgNtdYsW6pOjXmLCEq6voDK7esxJg/z8TBFBMAfr5jXYi48IkZHkJPYJ/uJ721q9ld3KHDDN3TbAZlysxEiFcvcc71wu+PcU00qGApBK7LrAUbRkduMhVo4k6TaXUh3cJfGi8U/S5Ap/fWnR97p+jbLLjU0+ASDSM/DBz2Go9inZnoQYnKSXXNbDz812Cm1Y5w2FkYBA==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: 6Eq0ce9a6B93tNE' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 5.0; Trident/6.0; .NET CLR 2.2.48053.4)' \
--header 'CHANNEL-ID: 00002' \
--header 'X-CLIENT-KEY: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--data '{
    "grantType": "AUTHORIZATION_CODE",
    "authCode": "ccc7cf6c087fead2e53aeef22469b69bc2a00b87e07d8f0d5841322a9e05b457"
}'

Sample Response

200 OK Successful Auth Code

Body
Header (12)

    //200 OK
    {
        "responseCode": "2007400",
        "responseMessage": "Successful",
        "tokenType": "Bearer",
        "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIwMTViZjgzNi1kNmFjLTRmNWUtYTc0NS1hODkxYjk1ZWRiNDYiLCJqdGkiOiJhYTcyMWIwOGI4Y2EzZGI0YjI2OGIzNmE0NDVjY2I4Zjg1ZTNlMzFhZTczZTdhMWUzODdhNTI2NTA0OTA3ZmJjNWRiMzA3OTg0ZjU2NzkyYiIsImlhdCI6MTc3OTIwNjkxMi40NjUwOSwibmJmIjoxNzc5MjA2OTEyLjQ2NTA5NywiZXhwIjoxNzgwNTAyOTEyLjQ0ODAwNSwic3ViIjoiMjM1Mjc0Iiwic2NvcGVzIjpbXX0.ClhtLge3jSVqPsaBNZI1ig-H_FAuXkLL9YJ3NoQdgXQV2fCygZ8MCPlCavdyJ6jgBUTbydG7yecJiMFSPQAJSKQINFB-CSjkvd_8zIcNDzPnWkAR5Nx7PGkCyVvC17XeiUjXlZuXZn6hgD3D6fty6DCKw8Igtv9LPM2ovfL4yuVAgKQkHtjVHcNplQAC1ufISlGZQTscJxvBY3a1vjJqGDKOfBAy3oQkcI-OsKBIcxGFbhEK_xNCp3--zif8cTvPoaYKLrY8wzbPhAYcxGrNTcyIpO09d9cIdpUkgvTyJ1X9gKj7bmPGkCQYT9SvcmkzqJvaGf5T5ydUcHmPgUrFZCjI70gwkdOckiVFhecrv9ru2wzNZrRQxpQQygNl35V5Swc47AEO7OpuS-VMqjzGTN3DRkJpJDpzOeoNFL_0go3fj5TiNb1r0_hv9jcEDehOzauETvGiaOClNCxqi2mJ9Ninu33XfDuKOWIK9ZQOjF2sTehRWP21H0x-UQ4kENTLS6U3ZbPu7x180Bnfz0mD9s8mbB8Qciae1XUf44YxAtJhGCSfKt2siy-eZGWTf3y_071y3TZmV6hvSE2OPfJxNa75D8iqJYUzhv1OP3TDeXkLi83mFxkCood8BLSduGXhxDjKzWisspoOtVAbDKMWBV7aWtbCn_DNqp6q6YbuugY",
        "accessTokenExpiryTime": "2026-06-03T23:08:32+07:00",
        "refreshToken": "def502003c97863bcbe273afd4cffabda58dc5de14b57b49eecfe6457f11806eaa88b00d3878c85656fd21832857f4dcc5cbe11b85c9aa5217a67c425795afc5c1b3562f6d0307a944a8cc910e549a6d4504dd95c0951e7320342097f94c1b51358084173d5db0770cf671cbb230372407db612a424670bbb1acdf7b485ee6be483d67fa1fc3aadb7119de75f9ee37e4eaf6730980e7f8f05b7b1656501f056b5bb48d0ee0cfd3103e8dc2243234273f5f3b094d94972345b8aef29e764daa7d7cfc031bca489580e1a2aae350a9af30a29582390247f983f5822e165dd292614693ca5cf47ffc2f2181f4c0a17666227908e235570bb6140742e4f0207c5ebffc971b62f2d54598a86e184fbf474c06efbdff4a99b84f8d622f21ebf1e4ed60991653e371601687b1c1dd1194a38ba8c240230536b366717f8a05e86078a20587e9174c24657fdde98260a3fdc1ab13826b1f20c6a06afaac5efdd0b01f706c5db9c93e181a19b18eea439ee14a48b8677dbe05246b939e47b9e82308905cff8909075153a0b3e475",
        "refreshTokenExpiryTime": "2026-06-18T23:08:32+07:00",
        "additionalInfo": {
            "accountId": "indra69"
        }
    }

200 OK Successful Refresh Token

Body
Header (12)

    //200 OK
    {
        "responseCode": "2007400",
        "responseMessage": "Successful",
        "tokenType": "Bearer",
        "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIwMTViZjgzNi1kNmFjLTRmNWUtYTc0NS1hODkxYjk1ZWRiNDYiLCJqdGkiOiIxYTk5NWIyOTFmZTU4NDNjMWVhYzdiNGYxOWM5YzdiYzhjZDNjZjI5NGUxOWU0MGI2YzYyNDBmZWFiMjFjYzRjZDI2YjdiNmY0MTMyOTI2OSIsImlhdCI6MTc3OTIwNjk4MS4zNTUyOTcsIm5iZiI6MTc3OTIwNjk4MS4zNTUzMDMsImV4cCI6MTc4MDUwMjk4MS4zNTAxOTcsInN1YiI6IjIzNTI3NCIsInNjb3BlcyI6W119.wW89mScg6dkCZP8wcXEhVx-QWwA3W0JR_kwNZ-8UVPUKqf4yzgiMLi5RuS5n8p5hQvQ1zbrcNVJqTY8ovhIiiVqDHVPd0Tmq0uOWe3f03-gV5ABIdj3zv4iJmpNDR_gp3wjVk4qWsPDVe2Sfx2UhTHa_WgrYuXWdGnIolr-2GlGY1QjypLAIciQp2AipmXQuYIqCt0pPj0ePuVwzJjfFwb8RXAFnrDHZgjl5g-oeMV-La3WXsTgkWRAJOQgMTSYBGdAVP9b6HizkL-0wSux80FVCWQY4iuy0LkUZxW6482mde9UJJt7PRV-cYqylogkp7wrfOtdYLUQz8jOV1RkhasxUzQpeg2c8mwWkroyB5_Pz9mWU5XgCCCOYz4eKPjOUY9Qmohvwacfz_2T9wd8hm6kPhu8SFqqIBCtOTg6kTj835ZuHsFfDagvHB5-jKVnSPvZaeynW1SlksnDz3yvOCwYg-a1RAkh63jCljk7Gj6TquqAy6JEWu4bpXOPK-gYBNGwNBKnQgnpRJpTCiNozLb-QYcrdyvV4Dmyn7pAeexd2ZDCTmjzV3OcDt3iXwT2E35-yNqHjkI5uhcT2G5cgVOeZIKmCGXKvefGrfTwhdm2PUGieNBMk9gQmD-epIH4lhBNrIDPK6HkcIWg-glvIWmrBJCEZapDDXsxrF4LMdMU",
        "accessTokenExpiryTime": "2026-06-03T23:09:41+07:00",
        "refreshToken": "def50200b2a37e37bc21a484c42f312538533e84be1f5cd8b51da033674efa81daa454208c32081efe4ed7f4495594ecf4c232783fa1aef8aefbe5f5b93a81486167887d7a439b2fe3f0565c23d82c27576d28e3540dfee166b13656da870175543158c21558fe3ad3aa10ce9e3fd05313a14838042837cdf5e6ce0efe1114ce79c893dee0a827990185063f1e818c6a5417ab83825c9a2301806916728505aa39f4cde5e003d89f2563fc2e8a232f2aed08d20a1b5d15d221bc92af7c1666a08ef3e4c2f12e2b5f9cf7f0d4058095b3122b1246873c3e9da1f4e23eb11dcbe0ec7d9ce6a64fd05f30bb569de44242ea19715cc0ac9b4d511a478c82a613dadf9a5d009f9ae31ec4cb2c39a9d3eba49f75656c5453c5703375098c4b3093231d07bbc8e108f24c2152b4f88daa46de1409f28ab20401d5482862bd1167acfd4fdf62c09f7aa5c98831dccb62bdf8d04d4b3dbb5d2ffab3fa3210bacf3ea12da87281588a7471727d01ef6dec35b9885b7034f6b8cfbc41771ca3bde3f89afd86813b3e93c23d0747cc",
        "refreshTokenExpiryTime": "2026-06-18T23:09:41+07:00",
        "additionalInfo": {
            "accountId": "indra69"
        }
    }

400 Bad Request

Body
Header (11)

    //400 Bad Request
    {
        "responseCode": "4007402",
        "responseMessage": "Invalid Mandatory Field (authCode)"
    }

Account Unbinding

`POST` Account Unbinding

This API is used to unbind a user's YUKK account from your platform, revoking your platform's access to the user's YUKK Wallet.

note

🌐 This API to Unbinding Account
https://sandbox.yukk.co/auth/openapi/v1.0/registration-account-unbinding

Specification Request

API Name	API Account Unbinding
Function	to unbind user's Yukk account wallet access from your platform
Service Code	09
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/registration-account-unbinding

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	M	Value always: `application/json`.
Authorization-Customer	String	M	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).
X-TIMESTAMP	String	M	Client's current local time in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	M	Digital signature generated using HMAC_SHA512 with your clientSecret as the key.
X-PARTNER-ID	String	M	Unique Partner Client ID
X-EXTERNAL-ID	String	M	Unique random transaction tracking string.
X-DEVICE-ID	String	M	User agent or unique hardware device ID (e.g., Mozilla/5.0...).

Request Body
The following table is a body of request parameter:

Field	Type	Attributes	Description
partnerReferenceNo	String (64)	M	Unique reference number generated by the partner. Example: YUKK-REG-20260704001
merchantId	String (64)	M	The active token authorizing access to the user's wallet. Example: 12234.

Bodyraw(json)

{
    "partnerReferenceNo": "TEST-ASPI_001",
    "merchantId": "99998"
}

Sample Request

//Account Unbinding 200 OK
curl --location --request POST 'https://sandbox.yukk.co/auth/v1.0/registration-account-unbinding' \
--header 'Content-Type: application/json' \
--header 'User-Agent: insomnia/8.5.1' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5' \
--header 'X-CLIENT-KEY: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-PARTNER-ID: a1ba1e12-0d12-4308-b961-f2a7f1a12345' \
--header 'X-EXTERNAL-ID: Pqnt8htcLsZfLzy' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.0) AppleWebKit/537.0.1 (KHTML, like Gecko) Chrome/28.0.815.0 Safari/537.0.1' \
--header 'CHANNEL-ID: 0002' \
--data ''

Sample Response

Body
Header (3)

    //200 OK
    {
      "responseCode": "2000900",
      "responseMessage": "Successful",
      "referenceNo": "UBD202403068UPPBSGG",
      "partnerReferenceNo": "TEST-YUKK_000",
      "merchantId": "1",
      "unlinkResult": "SUCCESS"
    }

Wallet

This API allows Partners to retrieve the current YUKK Cash balance of a user who has linked their YUKK account to the platform.

Top up

Manage wallet top-up transactions, including retrieving funding channels, creating Virtual Accounts or retail payment codes, checking fees, and tracking top-up status.

POST Get Bank Codes
This API is used to retrieve the active list of bank codes and retail partner codes supporting YUKK Wallet Top Up services.

note

🌐 This API to Get Bank Codes
https://sandbox.yukk.co/wallet/openapi/v1.0/bank-codes

Specification Request

API Name	API Get Bank Codes
Function	to get list of bank codes.
Service Code	00
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	…/{version}/bank-codes

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	M	Value always: `application/json`.
Authorization-Customer	String	M	Customer-level authorization token format: `Bearer <accessToken>` (starts with `Bearer` followed by your active B2B2C Access Token).
X-TIMESTAMP	String	M	Client's current local time in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	M	Digital signature generated automatically using HMAC_SHA512 with your clientSecret as the key.
X-PARTNER-ID	String	M	Unique Partner Client ID (e.g., a7e1535f-df4b-3c28-bdb3-ef48a53463a4).
X-EXTERNAL-ID	String	M	Unique transaction reference string (e.g., Sw3wBBlbHH2AfXh).
X-DEVICE-ID	String	M	User agent or unique hardware device ID (e.g., Mozilla/5.0...).
CHANNEL-ID	String	M	Value always: `00002`.
User-Agent	String	M	Client software identification string (e.g., insomnia/8.5.1).

Request Body
The following table is a body of request parameter:

Field	Type	Attributes	Description
action	String	M	The transaction intent action code. Example: TOPUP
channelType	String	M	Filter array representing the types of channels to query. Accepted array values: `BANK`, `RETAIL`. Example: ["BANK", "RETAIL"]

Bodyraw(json)

{
    "action": "TOPUP",
    "channelType": ["BANK", "RETAIL"]
}

Sample Request

200 OK Successful

//200 OK Successful
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/bank-codes' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: EXh7pEAmRYFA8bPHAjkjN+gOZdA/n/7ZLjvEnfjTVPfkTJElg/DmnVMJ4iu2dfOqLnk6tC5fPO5xAYnE2ixG+A==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: oy9GQ3kIeKm7sRb' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.3) AppleWebKit/535.2.2 (KHTML, like Gecko) Chrome/22.0.866.0 Safari/535.2.2' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "action": "TOPUP",
    "channelType": ["BANK", "RETAIL"]
}'

200 OK Successful

//200 OK Successful
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/bank-codes' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: EXh7pEAmRYFA8bPHAjkjN+gOZdA/n/7ZLjvEnfjTVPfkTJElg/DmnVMJ4iu2dfOqLnk6tC5fPO5xAYnE2ixG+A==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: ZytNZvkxHIqAg1K' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.2; rv:13.4) Gecko/20100101 Firefox/13.4.8' \
--header 'CHANNEL-ID: 00002' \
--data '{
"action": "TOPUP",
"channelType": ["BANK", "RETAIL"]
}'

Sample Response

200 OK Successful

Body
Header (10)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "bankList": [
            {
            "bankCode": 2,
            "bankName": "BCA",
            "bankType": "BANK"
            },
            {
            "bankCode": 3,
            "bankName": "Mandiri",
            "bankType": "BANK"
            },
            {
            "bankCode": 4,
            "bankName": "Permata",
            "bankType": "BANK"
            },
            {
            "bankCode": 12,
            "bankName": "BNI",
            "bankType": "BANK"
            },
            {
            "bankCode": 38,
            "bankName": "Alfamart",
            "bankType": "RETAIL"
            }
        ]
    }

200 OK Successful

Body
Header (10)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "bankList": [
            {
            "bankCode": 2,
            "bankName": "BCA",
            "bankType": "BANK"
            },
            {
            "bankCode": 3,
            "bankName": "Mandiri",
            "bankType": "BANK"
            },
            {
            "bankCode": 4,
            "bankName": "Permata",
            "bankType": "BANK"
            },
            {
            "bankCode": 12,
            "bankName": "BNI",
            "bankType": "BANK"
            },
            {
            "bankCode": 38,
            "bankName": "Alfamart",
            "bankType": "RETAIL"
            }
        ]
    }

POST Top Up Inquiry
This API is used to query the top-up transaction fees and confirm billing details for a specific bank code before creating a top-up request.

note

🌐 This API to Top Up Inquiry
https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/inquiry

Specification Request

API Name	API Top Up Inquiry
Function	to inquire top up fee information
Service Code	00
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/top-up/inquiry

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	(M)	Value always: `application/json`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
billDetails	M	Array of Object	Billing details
billAmount	M	Object	Billed amount details
value	M	String	The value of billed amount
currency	M	String (3)	The currency of billed amount
additionalInfo	O	Object	Additional Information
bankCode	M	Integer	The id of the selected bank codes

Bodyraw(json)

{
    "billDetails": [
        {
            "billAmount": {
                "value": "100000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 2
    }
}

Sample Request

Successful 200 OK

//Successful 200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: UhD7haJPelhsBpi' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.1) AppleWebKit/535.0.1 (KHTML, like Gecko) Chrome/25.0.886.0 Safari/535.0.1' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "billDetails": [
        {
            "billAmount": {
                "value": "20000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 16
    }
}'

Invalid Account 404

//Invalid Account 404
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: ue1snOjhqWIWu03' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.2) AppleWebKit/537.0.2 (KHTML, like Gecko) Chrome/38.0.880.0 Safari/537.0.2' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "billDetails": [
        {
            "billAmount": {
                "value": "20000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 16
    }
}'

Too Much Amount 403

//Too Much Amount 403
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: WzNNbubzmNEUv41' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.0) AppleWebKit/535.0.0 (KHTML, like Gecko) Chrome/14.0.827.0 Safari/535.0.0' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "billDetails": [
        {
            "billAmount": {
                "value": "20000000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 16
    }
}'

Invalid Amount 404

//Invalid Amount 404
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: VRj7FY9LAmcj3fT' \
--header 'X-DEVICE-ID: Opera/14.87 (Windows NT 6.3; U; UK Presto/2.9.189 Version/11.00)' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "billDetails": [
        {
            "billAmount": {
                "value": "10.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 16
    }
}'

Invalid Bank Code 404

//Invalid Bank Code 404
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: Ln5n51aICslFlUH' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.1; rv:12.5) Gecko/20100101 Firefox/12.5.1' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "billDetails": [
        {
            "billAmount": {
                "value": "20000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 100
    }
}'

Transaction Not Permitted 404

//Transaction Not Permited 404
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: PUdtAb8jmQwoEYx' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 7.0; Windows NT 6.3; Trident/4.1)' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "billDetails": [
        {
            "billAmount": {
                "value": "10.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 16
    }
}'

Sample Response

Successful 200 OK

Body
Header (16)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "billDetails": [
            {
            "billAmount": {
                "value": "20000.00",
                "currency": "IDR"
            },
            "feeAmount": {
                "value": "1500.00",
                "currency": "IDR"
            },
            "totalAmount": {
                "value": "21500.00",
                "currency": "IDR"
            }
            }
        ],
        "additionalInfo": {
            "bankCode": 16,
            "bankName": "Virtual Account BCA Nicepay"
        }
    }

Invalid Account 404

Body
Header (16)

    //404 NOT FOUND
    {
        "responseCode": "4040011",
        "responseMessage": "Invalid Account."
    }

Too Much Amount 403

Body
Header (11)

    //403 FORBIDDEN
    {
        "responseCode": "4030012",
        "responseMessage": "Exceeds Transaction Amount Limit"
    }

Invalid Amount 404

Body
Header (11)

    //404 NOT FOUND
    {
        "responseCode": "4040013",
        "responseMessage": "Invalid Amount"
    }

Invalid Bank Code 404

Body
Header (11)

    //404 NOT FOUND 
    {
        "responseCode": "4040003",
        "responseMessage": "Bank not supported by Switch."
    }

Transaction Not Permited 404

Body
Header (11)

    //404 NOT FOUND
    {
        "responseCode": "4040001",
        "responseMessage": "Transaction Not Permitted (KYC)"
    }

POST Create Top Up (for Non-Banks)
This API is used to query the top-up transaction fees and confirm billing details for a specific bank code before creating a top-up request.

note

🌐 This API to Create top up for non banks
https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/requests

Specification Request

API Name	API Create Top Up
Function	to get virtual account (VA) number for top up user's Yukk Cash.
Service Code	00
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/top-up/requests

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	(M)	Value always: `application/json`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
redirectUrl	M	String (256)	Callback URL after successful getAuthCode process
scopes	M	List (256)	Scope access from the selected authorization
state	M	String (32)	Random string for CSRF security purpose
seamlessData	M	String (512)	seamlessData = URLEncode({“mobileNumber” = “62xx”})
seamlessSign	M	String (512)	seamlessSign = URLEncode(sign(seamlessData))

Bodyraw(json)

{
    "trxId": "YUKKDOCS-02",
    "billDetails": [
        {
            "billAmount": {
                "value": "10000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 11
    }
}

Sample Request

Successful 200 OK

//Successful 200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/requests' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: XN4T5XiWD58F1Sc' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 7.0; Windows NT 6.2; Trident/5.0; .NET CLR 4.5.78819.5)' \
--header 'CHANNEL-ID: 0002' \
--data '{
    "trxId": "YUKKDOCS-01",
    "billDetails": [
        {
            "billAmount": {
                "value": "100000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 11
    }
}'

Invalid Bank Code 404

//Invalid Bank Code 404
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/requests' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: 2p2zDx6L33zvVTX' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.1) AppleWebKit/532.1.2 (KHTML, like Gecko) Chrome/25.0.865.0 Safari/532.1.2' \
--header 'CHANNEL-ID: 0002' \
--data '{
    "trxId": "YUKKDOCS-01",
    "billDetails": [
        {
            "billAmount": {
                "value": "100000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 2
    }
}'

Inconsistent Request 404

//Inconsistent Request 404
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/requests' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: 4MK7FuI43bwAWWc' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 7.0; Windows NT 5.0; Trident/3.0)' \
--header 'CHANNEL-ID: 0002' \
--data '{
    "trxId": "YUKKDOCS-01",
    "billDetails": [
        {
            "billAmount": {
                "value": "10000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 11
    }
}'

Too Much Amount 403

//Too Much Amount 403
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/requests' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: e7JvHE7hCCeaI5n' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 8.0; Windows NT 6.1; Trident/3.0)' \
--header 'CHANNEL-ID: 0002' \
--data '{
    "trxId": "YUKKDOCS-02",
    "billDetails": [
        {
            "billAmount": {
                "value": "100000000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 11
    }
}'

Invalid Amount 404

//Invalid Amount 404
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/requests' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: uY3S3r8CKvc3wjI' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_10_3)  AppleWebKit/536.1.2 (KHTML, like Gecko) Chrome/35.0.857.0 Safari/536.1.2' \
--header 'CHANNEL-ID: 0002' \
--data '{
    "trxId": "YUKKDOCS-02",
    "billDetails": [
        {
            "billAmount": {
                "value": "1000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 11
    }
}'

Duplicate PartnerReferenceNo 409

//Duplicate PartnerReferenceNo 409
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/requests' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: Z9abkiMOmGvG_En' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.3; Trident/6.0)' \
--header 'CHANNEL-ID: 0002' \
--data '{
    "trxId": "YUKKDOCS-01",
    "billDetails": [
        {
            "billAmount": {
                "value": "1000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 11
    }
}'

Sample Response

Successful 200 OK

Body
Header (16)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "transactionData": {
        "virtualAccountNo": "8888818564213855",
        "trxId": "YUKKDOCS-01",
        "totalAmount": {
            "value": "101000.00",
            "currency": "IDR"
        },
        "billDetails": [
            {
            "billAmount": {
                "value": "100000.00",
                "currency": "IDR"
            }
            }
        ],
        "feeAmount": {
            "value": "1000.00",
            "currency": "IDR"
        },
        "additionalInfo": {
            "bankCode": 11,
            "bankName": "DOKU ALFAMART",
            "referenceNo": "ODE240923790582950",
            "transactionTime": "2024-09-23T01:42:53+07:00"
        }
        }
    }

Invalid Bank Code 404

Body
Header (11)

    //404 NOT FOUND
    {
        "responseCode": "4040003",
        "responseMessage": "Bank not supported by Switch."
    }

Inconsistent Request 404

Body
Header (11)

    //404 NOT FOUND
    {
        "responseCode": "4040018",
        "responseMessage": "Inconsistent Request."
    }

Too Much Amount 403

Body
Header (11)

    //403 FORBIDDEN
    {
        "responseCode": "4030012",
        "responseMessage": "Exceeds Transaction Amount Limit"
    }

Invalid Amount 404

Body
Header (11)

    //404 NOT FOUND 
    {
        "responseCode": "4040013",
        "responseMessage": "Invalid Amount"
    }

Duplicate PartnerReferenceNo 409

Body
Header (11)

    //409 CONFLICT
    {
        "responseCode": "4090001",
        "responseMessage": "Duplicate partnerReferenceNo"
    }

POST Create VA (for Banks)
This API is used to query the top-up transaction fees and confirm billing details for a specific bank code before creating a top-up request.

note

🌐 This API to Create VA for banks
https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-va/create-va

Specification Request

API Name	API Create VA
Function	to get virtual account (VA) number for top up user's Yukk Cash.
Service Code	27
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/transfer-va/create-va

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	(M)	Value always: `application/json`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
redirectUrl	M	String (256)	Callback URL after successful getAuthCode process
scopes	M	List (256)	Scope access from the selected authorization
state	M	String (32)	Random string for CSRF security purpose
seamlessData	M	String (512)	seamlessData = URLEncode({“mobileNumber” = “62xx”})
seamlessSign	M	String (512)	seamlessSign = URLEncode(sign(seamlessData))

Bodyraw(json)

{
    "trxId": "TEST-ASPI_003",
    "billDetails": [
        {
            "billAmount": {
                "value": "20000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 18
    }
}

Sample Request

Successful 200 OK

//Successful 200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/requests' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: XN4T5XiWD58F1Sc' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 7.0; Windows NT 6.2; Trident/5.0; .NET CLR 4.5.78819.5)' \
--header 'CHANNEL-ID: 0002' \
--data '{
    "trxId": "YUKKDOCS-01",
    "billDetails": [
        {
            "billAmount": {
                "value": "100000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 11
    }
}'

Invalid Bank Code 404

//Invalid Bank Code 404
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/create-va' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: 6KBV2qiTWOQrPWT' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.2) AppleWebKit/533.1.0 (KHTML, like Gecko) Chrome/35.0.871.0 Safari/533.1.0' \
--header 'CHANNEL-ID: 0002' \
--data '{
    "trxId": "YUKKDOCS-01",
    "billDetails": [
        {
            "billAmount": {
                "value": "100000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 16
    }
}'

Inconsistent Request 404

//Inconsistent Request 404
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/create-va' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: ZxXvmWwPQuWhITu' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.3; Win64; x64; rv:9.7) Gecko/20100101 Firefox/9.7.8' \
--header 'CHANNEL-ID: 0002' \
--data '{
    "trxId": "YUKKDOCS-01",
    "billDetails": [
        {
            "billAmount": {
                "value": "10000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 16
    }
}'

Too Much Amount 403

//Too Much Amount 403
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/create-va' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: kx_6Eqm66ZmkRNQ' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_8_8 rv:2.0; SE) AppleWebKit/532.0.1 (KHTML, like Gecko) Version/5.0.10 Safari/532.0.1' \
--header 'CHANNEL-ID: 0002' \
--data '{
    "trxId": "YUKKDOCS-02",
    "billDetails": [
        {
            "billAmount": {
                "value": "100000000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 16
    }
}'

Invalid Amount 404

//Invalid Amount 404
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/create-va' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: pEe_rXThOhSmH1j' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 5.1) AppleWebKit/537.1.1 (KHTML, like Gecko) Chrome/32.0.821.0 Safari/537.1.1' \
--header 'CHANNEL-ID: 0002' \
--data '{
    "trxId": "YUKKDOCS-02",
    "billDetails": [
        {
            "billAmount": {
                "value": "1000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 16
    }
}'

Duplicate PartnerReferenceNo 409

//Duplicate PartnerReferenceNo 409
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/create-va' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: 3TeNZ436MEOitXB' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_2)  AppleWebKit/531.0.1 (KHTML, like Gecko) Chrome/39.0.813.0 Safari/531.0.1' \
--header 'CHANNEL-ID: 0002' \
--data '{
    "trxId": "YUKKDOCS-01",
    "billDetails": [
        {
            "billAmount": {
                "value": "1000.00",
                "currency": "IDR"
            }
        }
    ],
    "additionalInfo": {
        "bankCode": 16
    }
}'

Sample Response

Successful 200 OK

Body
Header (16)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "transactionData": {
        "virtualAccountNo": "8888818564213855",
        "trxId": "YUKKDOCS-01",
        "totalAmount": {
            "value": "101000.00",
            "currency": "IDR"
        },
        "billDetails": [
            {
            "billAmount": {
                "value": "100000.00",
                "currency": "IDR"
            }
            }
        ],
        "feeAmount": {
            "value": "1000.00",
            "currency": "IDR"
        },
        "additionalInfo": {
            "bankCode": 11,
            "bankName": "DOKU ALFAMART",
            "referenceNo": "ODE240923790582950",
            "transactionTime": "2024-09-23T01:42:53+07:00"
        }
        }
    }

Invalid Bank Code 404

Body
Header (11)

    //404 NOT FOUND
    {
        "responseCode": "4040003",
        "responseMessage": "Bank not supported by Switch."
    }

Inconsistent Request 404

Body
Header (11)

    //404 NOT FOUND
    {
        "responseCode": "4040018",
        "responseMessage": "Inconsistent Request."
    }

Too Much Amount 403

Body
Header (11)

    //403 FORBIDDEN
    {
        "responseCode": "4030012",
        "responseMessage": "Exceeds Transaction Amount Limit"
    }

Invalid Amount 404

Body
Header (11)

    //404 NOT FOUND 
    {
        "responseCode": "4040013",
        "responseMessage": "Invalid Amount"
    }

Duplicate PartnerReferenceNo 409

Body
Header (11)

    //409 CONFLICT
    {
        "responseCode": "4090001",
        "responseMessage": "Duplicate partnerReferenceNo"
    }

GET Check Top Up Status
This API is used to actively query the real-time payment status of an initiated Top Up transaction directly from the YUKK gateway.

note

🌐 This API to Checking top up status
https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/ODE260520758618608

Specification Request

API Name	API Check Top Up Status
Function	to check user's top up status.
Service Code	00
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/top-up/{referenceNo}

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	(M)	Value always: `application/json`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
redirectUrl	M	String (256)	Callback URL after successful getAuthCode process
scopes	M	List (256)	Scope access from the selected authorization
state	M	String (32)	Random string for CSRF security purpose
seamlessData	M	String (512)	seamlessData = URLEncode({“mobileNumber” = “62xx”})
seamlessSign	M	String (512)	seamlessSign = URLEncode(sign(seamlessData))

Sample Request

Successful 200 OK

//Successful 200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/ODE260520758618608' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: a9yZkYUtBq_yPp_' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.3; Trident/7.0; Touch; rv:11.0) like Gecko' \
--header 'CHANNEL-ID: 0002'

Transaction Not Found 404

//Transaction Not Found 404
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/top-up/ODE260520758618608' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: 9511d663-d8e7-435d-afb4-4bcf3047b6bg' \
--header 'X-EXTERNAL-ID: SC6xJ2SKDRoBgtc' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.0) AppleWebKit/535.2.1 (KHTML, like Gecko) Chrome/36.0.822.0 Safari/535.2.1' \
--header 'CHANNEL-ID: 0002'

Sample Response

Successful 200 OK

Body
Header (16)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "referenceNo": "ODE240920628772382",
        "trxId": "1234567890123456789012345678901234567890123456789012345678901234657438920480328843927490230948392084902",
        "status": "ACCEPTED",
        "transactionTime": "2024-09-20T14:05:24+07:00",
        "expiredDate": "2024-09-27T14:05:24+07:00",
        "yukkId": "indr96",
        "bankCode": 16,
        "bankName": "Virtual Account BCA Nicepay",
        "billDetails": [
        {
            "billAmount": [
            {
                "value": "10000.00",
                "currency": "IDR"
            }
            ],
            "feeAmount": [
            {
                "value": "1500.00",
                "currency": "IDR"
            }
            ],
            "totalAmount": [
            {
                "value": "11500.00",
                "currency": "IDR"
            }
            ]
        }
        ]
    }

Transaction Not Found 404

Body
Header (11)

    //404 NOT FOUND
    {
        "responseCode": "4040001",
        "responseMessage": "Transaction not found."
    }

Transfer

Transfer funds to bank accounts or other YUKK Wallet users, validate recipients, and monitor transfer status.

POST Transfer Inquiry (Bank)
This API is used to actively query the real-time payment status of an initiated Top Up transaction directly from the YUKK gateway.

note

🌐 This API to Transfer Inquiry via Bank
https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry

Specification Request

API Name	API Transfer Inquiry
Function	to inquire transfer fee information to bank account
Service Code	00
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/transfer/inquiry

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	(M)	Value always: `application/json`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
partnerReferenceNo	M	String (64)	Unique Partner's reference number / transaction ID
amount	M	Object	Transfer amount
value	M	Decimal (16,2)	Transfer amount value
currency	M	String (3)	Transfer amount currency
beneficiaryAccountNo	M	String (20)	Beneficiary's bank account number
beneficiaryBankCode	M	String (8)	Beneficiary's bank code which is retrieved from API Get Bank Codes
sourceAccountNo	M	String (20)	Source of Yukk ID account
additionalInfo	M	Object	Additional information
destinationType	M	String (20)	Destination type. Value: `BANK`

Bodyraw(json)

{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "25000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "BANK"
    }
}

Sample Request

200 OK

//200 OK
curl --location -g 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: iCSVbLT0SwVxr2aj1Am6AYNvh4WbIiX5hndLDgk9+ie5Jyy4+8558erApae026YFquTBIbOa5I+SZIDB5vLO0g==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: yFOPBOq9Vq30Ovz' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 5.3) AppleWebKit/533.0.0 (KHTML, like Gecko) Chrome/27.0.820.0 Safari/533.0.0' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "25000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "BANK"
    }
}'

403 Insufficient Funds

//403 Insufficient Funds
curl --location -g 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: iCSVbLT0SwVxr2aj1Am6AYNvh4WbIiX5hndLDgk9+ie5Jyy4+8558erApae026YFquTBIbOa5I+SZIDB5vLO0g==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: HIdyWRoKBPGUDSj' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_7_1)  AppleWebKit/532.0.0 (KHTML, like Gecko) Chrome/13.0.889.0 Safari/532.0.0' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "30000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "BANK"
    }
}'

403 Invalid Bank Code

//403 Invalid Bank Code
curl --location -g 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: iCSVbLT0SwVxr2aj1Am6AYNvh4WbIiX5hndLDgk9+ie5Jyy4+8558erApae026YFquTBIbOa5I+SZIDB5vLO0g==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: SjNVgNoLFaikAnU' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 5.3) AppleWebKit/532.1.1 (KHTML, like Gecko) Chrome/16.0.813.0 Safari/532.1.1' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "30000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryBankCode": "BCAX",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "BANK"
    }
}'

403 Inactive Account

//403 Inactive Account
curl --location -g 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: iCSVbLT0SwVxr2aj1Am6AYNvh4WbIiX5hndLDgk9+ie5Jyy4+8558erApae026YFquTBIbOa5I+SZIDB5vLO0g==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: gSBtAs37XV2tnmJ' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 7.0; Windows NT 5.0; Trident/3.0; .NET CLR 1.0.47079.6)' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "30000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryBankCode": "BCAX",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "BANK"
    }
}'

404 Invalid Amount

//404 Invalid Amount 
curl --location -g 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: iCSVbLT0SwVxr2aj1Am6AYNvh4WbIiX5hndLDgk9+ie5Jyy4+8558erApae026YFquTBIbOa5I+SZIDB5vLO0g==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: lJaqSGw9qsBGt9P' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.2) AppleWebKit/532.2.2 (KHTML, like Gecko) Chrome/39.0.860.0 Safari/532.2.2' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "100.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "BANK"
    }
}'

403 Feature Not Allowed

//403 Feature Not Allowed
curl --location -g 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: iCSVbLT0SwVxr2aj1Am6AYNvh4WbIiX5hndLDgk9+ie5Jyy4+8558erApae026YFquTBIbOa5I+SZIDB5vLO0g==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: xQPqraJTq542jD9' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.1) AppleWebKit/536.2.2 (KHTML, like Gecko) Chrome/39.0.843.0 Safari/536.2.2' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "1000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "BANK"
    }
}'

404 Transaction Not Permitted

//404 Transaction Not Permitted
curl --location -g 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: iCSVbLT0SwVxr2aj1Am6AYNvh4WbIiX5hndLDgk9+ie5Jyy4+8558erApae026YFquTBIbOa5I+SZIDB5vLO0g==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: EM_X_DBaRF_u_hI' \
--header 'X-DEVICE-ID: Opera/9.37 (Windows NT 5.3; U; MG Presto/2.9.185 Version/12.00)' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "1000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "BANK"
    }
}'

403 Exceeds Transaction Amount Limit

//403 Exceeds Transaction Amount Limit
curl --location -g 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: iCSVbLT0SwVxr2aj1Am6AYNvh4WbIiX5hndLDgk9+ie5Jyy4+8558erApae026YFquTBIbOa5I+SZIDB5vLO0g==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: mT7AWzqT1I8KULt' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.3; rv:15.8) Gecko/20100101 Firefox/15.8.6' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "25000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "BANK"
    }
}'

Sample Response

200 OK

Body
Header (10)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "amount": {
        "value": "25000.00",
        "currency": "IDR"
        },
        "beneficiaryAccountNo": "0092190631",
        "beneficiaryAccountName": "TEST",
        "beneficiaryBankCode": "BCA",
        "additionalInfo": {
        "destinationType": "BANK",
        "beneficiaryBankName": "Bank Central Asia",
        "feeAmount": {
            "value": "2000.00",
            "currency": "IDR"
        },
        "totalAmount": {
            "value": "27000.00",
            "currency": "IDR"
        }
        }
    }

403 Insufficient Funds

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4030014",
        "responseMessage": "Insufficient Funds"
    }

403 Invalid Bank Code

Body
Header (10)

    //404 NOT FOUND
    {
        "responseCode": "4040003",
        "responseMessage": "Bank not supported by Switch."
    }

403 Inactive Account

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4030018",
        "responseMessage": "Inactive Account"
    }

404 Invalid Amount

Body
Header (10)

    //404 NOT FOUND 
    {
        "responseCode": "4040013",
        "responseMessage": "Invalid Amount"
    }

403 Feature Not Allowed

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4030001",
        "responseMessage": "Feature Not Allowed. No Permission."
    }

404 Transaction Not Permitted

Body
Header (10)

    //404 NOT FOUND
    {
        "responseCode": "4040001",
        "responseMessage": "Transaction Not Permitted. KYC is required"
    }

403 Exceeds Transaction Amount Limit

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4030012",
        "responseMessage": "Exceeds Transaction Amount Limit"
    }

POST Interbank Transfer (Bank)
This API is used to actively query the real-time status of an initiated interbank transfer transaction directly from the participating bank's network.

note

🌐 This API to Interbank Transfer via Bank
https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank

Specification Request

API Name	API Interbank Transfer
Function	to get user’s Yukk Cash Balance
Service Code	18
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/transfer-interbank

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	(M)	Value always: `application/json`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
partnerReferenceNo	M	String (64)	Unique Partner's reference number / transaction ID
amount	M	Object	Transfer amount
value	M	Decimal (16,2)	Transfer amount value
currency	M	String (3)	Transfer amount currency
beneficiaryAccountNo	M	String (20)	Beneficiary's bank account number
beneficiaryAccountName	M	String (100)	Beneficiary's bank account name
beneficiaryBankCode	M	String (8)	Beneficiary's bank code which is retrieved from API Get Bank Codes
sourceAccountNo	M	String (20)	Source of Yukk ID account
transactionDate	M	String (30)	Transaction date using current timestamp Format: Timestamp
additionalInfo	M	Object	Additional information
destinationType	M	String (20)	Destination type Value: `BANK`
urlParam	M	Array of Object	URL parameters
url	M	String (512)	URL link
type	M	String (24)	URL typeValue: - `PAY_RETURN` -> callback URL - `PAY_NOTIFY` -> webhook URL to get transfer notification

Bodyraw(json)

{
    "partnerReferenceNo": "test-06",
    "amount": {
        "value": "20000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryAccountName": "TEST",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "dev19",
    "transactionDate": "2025-05-03T17:14:34+07:00",
    "additionalInfo": {
        "destinationType": "BANK",
        "urlParam": [
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}

Sample Request

200 OK

//200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: PcTS//lGoWK9PmrBLIS4ffLBmPVyn6Q9zVpy/1SV7UUjAu8RkLd+oYKzE7g3tDjD/QUe6dLiIduKLJSxcGw5aw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: muD2CITx9YPFoa4' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.2) AppleWebKit/532.1.2 (KHTML, like Gecko) Chrome/23.0.876.0 Safari/532.1.2' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TEST-ASPI_004",
    "amount": {
        "value": "25000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryAccountName": "TEST",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "indra69",
    "transactionDate": "2025-05-03T17:14:34+07:00",
    "additionalInfo": {
        "destinationType": "BANK",
        "urlParam": [
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

409 Duplicate Ref

//409 Duplicate Ref
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: PcTS//lGoWK9PmrBLIS4ffLBmPVyn6Q9zVpy/1SV7UUjAu8RkLd+oYKzE7g3tDjD/QUe6dLiIduKLJSxcGw5aw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: x27mv5kUA4O1M1q' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.3; Trident/7.0; rv:11.0) like Gecko' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "test-02",
    "amount": {
        "value": "20000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryAccountName": "TEST",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "indra69",
    "transactionDate": "2025-05-03T17:14:34+07:00",
    "additionalInfo": {
        "destinationType": "BANK",
        "urlParam": [
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

403 Insufficient Funds

//403 Insufficient Funds
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: PcTS//lGoWK9PmrBLIS4ffLBmPVyn6Q9zVpy/1SV7UUjAu8RkLd+oYKzE7g3tDjD/QUe6dLiIduKLJSxcGw5aw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: saHu54MUp0yBSVa' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_8_9 rv:6.0; RM) AppleWebKit/535.2.1 (KHTML, like Gecko) Version/5.0.7 Safari/535.2.1' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "test-05",
    "amount": {
        "value": "1000000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryAccountName": "TEST",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "indra69",
    "transactionDate": "2025-05-03T17:14:34+07:00",
    "additionalInfo": {
        "destinationType": "BANK",
        "urlParam": [
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

403 Invalid Bank Code

//403 Invalid Bank Code
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: PcTS//lGoWK9PmrBLIS4ffLBmPVyn6Q9zVpy/1SV7UUjAu8RkLd+oYKzE7g3tDjD/QUe6dLiIduKLJSxcGw5aw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: saHu54MUp0yBSVa' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_8_9 rv:6.0; RM) AppleWebKit/535.2.1 (KHTML, like Gecko) Version/5.0.7 Safari/535.2.1' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "test-05",
    "amount": {
        "value": "1000000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryAccountName": "TEST",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "indra69",
    "transactionDate": "2025-05-03T17:14:34+07:00",
    "additionalInfo": {
        "destinationType": "BANK",
        "urlParam": [
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

403 Inactive Account

//403 Inactive Account
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: PcTS//lGoWK9PmrBLIS4ffLBmPVyn6Q9zVpy/1SV7UUjAu8RkLd+oYKzE7g3tDjD/QUe6dLiIduKLJSxcGw5aw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: MEt5w7hrFxRWQiy' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 5.1) AppleWebKit/533.0.1 (KHTML, like Gecko) Chrome/25.0.841.0 Safari/533.0.1' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "test-05",
    "amount": {
        "value": "1000000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryAccountName": "TEST",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "indra69",
    "transactionDate": "2025-05-03T17:14:34+07:00",
    "additionalInfo": {
        "destinationType": "BANK",
        "urlParam": [
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

403 Dormant Account

//403 Dormant Account
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: PcTS//lGoWK9PmrBLIS4ffLBmPVyn6Q9zVpy/1SV7UUjAu8RkLd+oYKzE7g3tDjD/QUe6dLiIduKLJSxcGw5aw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: z4KcjMVxu6GvZQw' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.3) AppleWebKit/532.2.1 (KHTML, like Gecko) Chrome/17.0.899.0 Safari/532.2.1' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "test-05",
    "amount": {
        "value": "1000000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryAccountName": "TEST",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "indra69",
    "transactionDate": "2025-05-03T17:14:34+07:00",
    "additionalInfo": {
        "destinationType": "BANK",
        "urlParam": [
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

403 Feature Not Allowed

//403 Feature Not Allowed
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: PcTS//lGoWK9PmrBLIS4ffLBmPVyn6Q9zVpy/1SV7UUjAu8RkLd+oYKzE7g3tDjD/QUe6dLiIduKLJSxcGw5aw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: CsO3bNUJl1QHINZ' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.2) AppleWebKit/532.1.2 (KHTML, like Gecko) Chrome/15.0.808.0 Safari/532.1.2' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "test-05",
    "amount": {
        "value": "1000000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryAccountName": "TEST",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "indra69",
    "transactionDate": "2025-05-03T17:14:34+07:00",
    "additionalInfo": {
        "destinationType": "BANK",
        "urlParam": [
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

404 Transaction Not Permitted

//404 Transaction Not Permitted
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: PcTS//lGoWK9PmrBLIS4ffLBmPVyn6Q9zVpy/1SV7UUjAu8RkLd+oYKzE7g3tDjD/QUe6dLiIduKLJSxcGw5aw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: 1xlAcghVIUenOcu' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.3) AppleWebKit/538.0.1 (KHTML, like Gecko) Chrome/35.0.827.0 Safari/538.0.1' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "test-05",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryAccountName": "TEST",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "indra69",
    "transactionDate": "2025-05-03T17:14:34+07:00",
    "additionalInfo": {
        "destinationType": "BANK",
        "urlParam": [
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

403 Exceeds Transaction Amount Limit

//403 Exceeds Transaction Amount Limit
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: PcTS//lGoWK9PmrBLIS4ffLBmPVyn6Q9zVpy/1SV7UUjAu8RkLd+oYKzE7g3tDjD/QUe6dLiIduKLJSxcGw5aw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: pYLg_iebfsovW37' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.2; Win64; x64; rv:13.2) Gecko/20100101 Firefox/13.2.6' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "test-05",
    "amount": {
        "value": "20000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "0092190631",
    "beneficiaryAccountName": "TEST",
    "beneficiaryBankCode": "BCA",
    "sourceAccountNo": "indra69",
    "transactionDate": "2025-05-03T17:14:34+07:00",
    "additionalInfo": {
        "destinationType": "BANK",
        "urlParam": [
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://yukk.co.id/webhook",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

Sample Response

200 OK

Body
Header (10)

    //200 OK
    {
        "responseCode": "2001800",
        "responseMessage": "Successful",
        "referenceNo": "WDRR260520642615797",
        "partnerReferenceNo": "TEST-ASPI_004",
        "amount": {
        "value": "25000.00",
        "currency": "IDR"
        },
        "beneficiaryAccountNo": "0092190631",
        "beneficiaryBankCode": "BCA",
        "additionalInfo": {
        "destinationType": "BANK",
        "urlParam": [
            {
            "url": "https://yukk.co.id/webhook",
            "type": "PAY_RETURN"
            },
            {
            "url": "https://yukk.co.id/webhook",
            "type": "PAY_NOTIFY"
            }
        ],
        "beneficiaryBankName": "Bank Central Asia",
        "beneficiaryAccountName": "TEST",
        "feeAmount": {
            "value": "2000.00",
            "currency": "IDR"
        },
        "totalAmount": {
            "value": "27000.00",
            "currency": "IDR"
        },
        "redirectUrl": "http://wallet.yukk.local/wallet?ref_id=fa3ea282a47dc05cc9759f04c7d44ece220077117403f1454666cc9bf2cdc355"
        }
    }

409 Duplicate Ref

Body
Header (10)

    //409 CONFLICT
    {
        "responseCode": "4091801",
        "responseMessage": "Duplicate partnerReferenceNo"
    }

403 Insufficient Funds

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4031814",
        "responseMessage": "Insufficient Funds"
    }

403 Invalid Bank Code

Body
Header (10)

    //404 NOT FOUND
    {
        "responseCode": "4041803",
        "responseMessage": "Bank not supported by Switch."
    }

403 Inactive Account

Body
Header (10)

    //403 FORBIDDEN 
    {
        "responseCode": "4031818",
        "responseMessage": "Inactive Account"
    }

403 Dormant Account

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4031818",
        "responseMessage": "Dormant Account"
    }

403 Feature Not Allowed

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4031801",
        "responseMessage": "Feature Not Allowed. No Permission."
    }

404 Transaction Not Permitted

Body
Header (10)

    //404 NOT FOUND
    {
        "responseCode": "4041801",
        "responseMessage": "Transaction Not Permitted. KYC is required"
    }

403 Exceeds Transaction Amount Limit

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4031812",
        "responseMessage": "Exceeds Transaction Amount Limit"
    }

POST Transfer Inquiry (YUKK)
This API is used to actively query the real-time status of an initiated transfer transaction directly from the YUKK gateway.

note

🌐 This API to Transfer Inquiry via YUKK
https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry

Specification Request

API Name	API Transfer Inquiry
Function	to inquire transfer fee information to YUKK account
Service Code	00
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/transfer/inquiry

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	(M)	Value always: `application/json`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
partnerReferenceNo	M	String (64)	Unique Partner's reference number / transaction ID
amount	M	Object	Transfer amount
value	M	Decimal (16,2)	Transfer amount value
currency	M	String (3)	Transfer amount currency
beneficiaryAccountNo	M	String (20)	Destination Yukk ID account
beneficiaryAccountName	M	String (100)	Destination Yukk account name
beneficiaryBankCode	M	String (8)	Beneficiary's bank code Value: `YUKK`
sourceAccountNo	M	String (20)	Source Yukk ID account
additionalInfo	M	Object	Additional information
destinationType	M	String (20)	Destination type. Value: `EWALLET_YUKK`

Bodyraw(json)

{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "25000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK"
    }
}

Sample Request

200 OK

//200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: EZz50l0CkWJr/UsU6K/F4InISYVr1GpB1mxrlpM6effRwGPfQQ6CpbWGoGxzcNsAltaGxVBReL3+1lPP0nWSpg==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: rTUwwNON28jEVmo' \
--header 'X-DEVICE-ID: Mozilla/5.0 (X11; Linux i686 AppleWebKit/536.0.2 (KHTML, like Gecko) Chrome/35.0.827.0 Safari/536.0.2' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK"
    }
}'

404 Invalid Account

//404 Invalid Account
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: EZz50l0CkWJr/UsU6K/F4InISYVr1GpB1mxrlpM6effRwGPfQQ6CpbWGoGxzcNsAltaGxVBReL3+1lPP0nWSpg==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: AsQd1LIfLsskElW' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.2) AppleWebKit/535.1.0 (KHTML, like Gecko) Chrome/27.0.874.0 Safari/535.1.0' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "a",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK"
    }
}'

404 Invalid Amount

//404 Invalid Amount
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: EZz50l0CkWJr/UsU6K/F4InISYVr1GpB1mxrlpM6effRwGPfQQ6CpbWGoGxzcNsAltaGxVBReL3+1lPP0nWSpg==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: tPNpuo5A04PZCXw' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 5.2; rv:9.2) Gecko/20100101 Firefox/9.2.0' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "100.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK"
    }
}'

403 Insufficient Funds

//403 Insufficient Funds
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: EZz50l0CkWJr/UsU6K/F4InISYVr1GpB1mxrlpM6effRwGPfQQ6CpbWGoGxzcNsAltaGxVBReL3+1lPP0nWSpg==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: kepADpjBL64arxr' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.3; WOW64; rv:7.5) Gecko/20100101 Firefox/7.5.9' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "2500000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK"
    }
}'

403 Exceeds Transaction Amount Limit

//403 Exceeds Transaction Amount Limit
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: EZz50l0CkWJr/UsU6K/F4InISYVr1GpB1mxrlpM6effRwGPfQQ6CpbWGoGxzcNsAltaGxVBReL3+1lPP0nWSpg==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: C_3J9ySCjrkEdxc' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 5.3) AppleWebKit/538.0.1 (KHTML, like Gecko) Chrome/39.0.861.0 Safari/538.0.1' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "25000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK"
    }
}'

403 Feature Not Allowed

//403 Feature Not Allowed
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: EZz50l0CkWJr/UsU6K/F4InISYVr1GpB1mxrlpM6effRwGPfQQ6CpbWGoGxzcNsAltaGxVBReL3+1lPP0nWSpg==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: y3RsMLy0cZvWUri' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 8.0; Windows NT 5.1; Trident/3.1)' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "25000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK"
    }
}'

404 Transaction Not Permitted

//404 Transaction Not Permitted
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: EZz50l0CkWJr/UsU6K/F4InISYVr1GpB1mxrlpM6effRwGPfQQ6CpbWGoGxzcNsAltaGxVBReL3+1lPP0nWSpg==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: LjoMW__OEnhIq7x' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.2; Trident/7.0; rv:11.0) like Gecko' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "25000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK"
    }
}'

403 Dormant Account

//403 Dormant Account
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: EZz50l0CkWJr/UsU6K/F4InISYVr1GpB1mxrlpM6effRwGPfQQ6CpbWGoGxzcNsAltaGxVBReL3+1lPP0nWSpg==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: 57DJ5e9D6A7WGGm' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 5.0; Trident/3.1)' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "25000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK"
    }
}'

403 Inactive Account

//403 Inactive Account
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: EZz50l0CkWJr/UsU6K/F4InISYVr1GpB1mxrlpM6effRwGPfQQ6CpbWGoGxzcNsAltaGxVBReL3+1lPP0nWSpg==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: OjXP7doohya2qFb' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.1) AppleWebKit/534.1.2 (KHTML, like Gecko) Chrome/16.0.858.0 Safari/534.1.2' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_01",
    "amount": {
        "value": "25000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK"
    }
}'

Sample Response

200 OK

Body
Header (10)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "amount": {
        "value": "10000.00",
        "currency": "IDR"
        },
        "beneficiaryAccountNo": "ata",
        "beneficiaryAccountName": "Ata",
        "beneficiaryBankCode": "YUKK",
        "additionalInfo": {
        "destinationType": "EWALLET_YUKK",
        "beneficiaryBankName": "YUKK",
        "feeAmount": {
            "value": "0.00",
            "currency": "IDR"
        },
        "totalAmount": {
            "value": "10000.00",
            "currency": "IDR"
        }
        }
    }

404 Invalid Account

Body
Header (10)

    //404 NOT FOUND
    {
        "responseCode": "4040011",
        "responseMessage": "Invalid Account."
    }

404 Invalid Amount

Body
Header (10)

    //404 NOT FOUND
    {
        "responseCode": "4040013",
        "responseMessage": "Invalid Amount"
    }

403 Insufficient Funds

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4030014",
        "responseMessage": "Insufficient Funds"
    }

403 Exceeds Transaction Amount Limit

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4030012",
        "responseMessage": "Exceeds Transaction Amount Limit"
    }

403 Feature Not Allowed

Body
Header (10)

    //403 FORBIDDEN 
    {
        "responseCode": "4030001",
        "responseMessage": "Feature Not Allowed. No Permission."
    }

404 Transaction Not Permitted

Body
Header (10)

    //404 NOT FOUND
    {
        "responseCode": "4040001",
        "responseMessage": "Transaction Not Permitted. KYC is required."
    }

403 Dormant Account

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4030018",
        "responseMessage": "Dormant Account"
    }

403 Inactive Account

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4030018",
        "responseMessage": "Inactive Account"
    }

POST Interbank Transfer (YUKK)
This API is used to actively query the real-time status of an initiated Interbank Transfer transaction directly from the YUKK gateway.

note

🌐 This API to Interbank Transfer via YUKK
https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank

Specification Request

API Name	API Interbank Transfer
Function	to get user’s Yukk Cash Balance
Service Code	18
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/transfer-interbank

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	(M)	Value always: `application/json`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
partnerReferenceNo	M	String (64)	Unique Partner's reference number / transaction ID
amount	M	Object	Transfer amount
state	M	String (32)	Random string for CSRF security purpose
value	M	Decimal (16,2)	Transfer amount value
currency	M	String (3)	Transfer amount currency
beneficiaryAccountNo	M	String (20)	Destination Yukk ID account
beneficiaryAccountName	M	String (100)	Destination Yukk account name
beneficiaryBankCode	M	String (8)	Beneficiary's bank code Value: `YUKK`
sourceAccountNo	M	String (20)	Source Yukk ID account
transactionDate	M	String (30)	Transaction date using current timestamp Format: Timestamp
additionalInfo	M	Object	Additional information
destinationType	M	String (20)	Destination type Value: `EWALLET_YUKK`
urlParam	M	Array of Object	URL parameters
url	M	String (512)	URL link
type	M	String (20)	URL typeValue: - `PAY_RETURN` -> callback URL - `PAY_NOTIFY` -> webhook URL to get transfer notification

Bodyraw(json)

{
    "partnerReferenceNo": "TESTPROD_04",
    "amount": {
        "value": "5200000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryAccountName": "Ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "transactionDate": "2024-10-03T20:50:00+00:00",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK",
        "urlParam": [
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}

Sample Request

200 OK

//200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: H+9FOd47wb2d2Fg/YoOBSd3Crkfe+UYdUYcvU2hAwE7lkNLq7SQhISuep0nmtudhA9qdwv1ipoDSWFSXn4C7Lw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: LErBuvLHics5EmN' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 5.2; rv:10.8) Gecko/20100101 Firefox/10.8.2' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_02",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryAccountName": "Ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "transactionDate": "2024-10-03T20:50:00+00:00",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK",
        "urlParam": [
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

403 Inactive Account

//403 Inactive Account
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: H+9FOd47wb2d2Fg/YoOBSd3Crkfe+UYdUYcvU2hAwE7lkNLq7SQhISuep0nmtudhA9qdwv1ipoDSWFSXn4C7Lw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: qStPy9dE6hZfO2u' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.1) AppleWebKit/537.0.0 (KHTML, like Gecko) Chrome/17.0.867.0 Safari/537.0.0' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_02",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryAccountName": "Ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "transactionDate": "2024-10-03T20:50:00+00:00",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK",
        "urlParam": [
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

403 Dormant Account

//403 Dormant Account
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: H+9FOd47wb2d2Fg/YoOBSd3Crkfe+UYdUYcvU2hAwE7lkNLq7SQhISuep0nmtudhA9qdwv1ipoDSWFSXn4C7Lw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: qlxFUHLtPdvVnWT' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 5.1) AppleWebKit/533.2.1 (KHTML, like Gecko) Chrome/36.0.872.0 Safari/533.2.1' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_02",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryAccountName": "Ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "transactionDate": "2024-10-03T20:50:00+00:00",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK",
        "urlParam": [
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

409 Duplicate Ref

//409 Duplicate Ref
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: H+9FOd47wb2d2Fg/YoOBSd3Crkfe+UYdUYcvU2hAwE7lkNLq7SQhISuep0nmtudhA9qdwv1ipoDSWFSXn4C7Lw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: qPTcPI0mGHIQlRl' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.2; Trident/7.0; Touch; rv:11.0) like Gecko' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_02",
    "amount": {
        "value": "100.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryAccountName": "Ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "transactionDate": "2024-10-03T20:50:00+00:00",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK",
        "urlParam": [
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

404 Invalid Amount

//404 Invalid Amount
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: H+9FOd47wb2d2Fg/YoOBSd3Crkfe+UYdUYcvU2hAwE7lkNLq7SQhISuep0nmtudhA9qdwv1ipoDSWFSXn4C7Lw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: UPQquM5UZTXJT5k' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_9_9)  AppleWebKit/533.2.2 (KHTML, like Gecko) Chrome/28.0.867.0 Safari/533.2.2' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_03",
    "amount": {
        "value": "100.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryAccountName": "Ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "transactionDate": "2024-10-03T20:50:00+00:00",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK",
        "urlParam": [
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

403 Exceeds Transaction Amount Limit

//403 Exceeds Transaction Amount Limit
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: H+9FOd47wb2d2Fg/YoOBSd3Crkfe+UYdUYcvU2hAwE7lkNLq7SQhISuep0nmtudhA9qdwv1ipoDSWFSXn4C7Lw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: pnDlM4kOIkSUxL0' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 5.0) AppleWebKit/534.2.2 (KHTML, like Gecko) Chrome/14.0.863.0 Safari/534.2.2' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_03",
    "amount": {
        "value": "52000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryAccountName": "Ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "transactionDate": "2024-10-03T20:50:00+00:00",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK",
        "urlParam": [
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

403 Insufficient Funds

//403 Insufficient Funds
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: H+9FOd47wb2d2Fg/YoOBSd3Crkfe+UYdUYcvU2hAwE7lkNLq7SQhISuep0nmtudhA9qdwv1ipoDSWFSXn4C7Lw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: fgiiSVaWtD_EgGg' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 5.1) AppleWebKit/531.0.0 (KHTML, like Gecko) Chrome/20.0.828.0 Safari/531.0.0' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_04",
    "amount": {
        "value": "5200000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryAccountName": "Ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "transactionDate": "2024-10-03T20:50:00+00:00",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK",
        "urlParam": [
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

403 Feature Not Allowed

//403 Feature Not Allowed
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: H+9FOd47wb2d2Fg/YoOBSd3Crkfe+UYdUYcvU2hAwE7lkNLq7SQhISuep0nmtudhA9qdwv1ipoDSWFSXn4C7Lw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: hDshD0NCIYr4qdp' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.0; Win64; x64; rv:11.1) Gecko/20100101 Firefox/11.1.0' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_04",
    "amount": {
        "value": "5200000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryAccountName": "Ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "transactionDate": "2024-10-03T20:50:00+00:00",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK",
        "urlParam": [
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

404 Transaction Not Permitted

//404 Transaction Not Permitted
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-10-03T09:45:00+07:00' \
--header 'X-SIGNATURE: H+9FOd47wb2d2Fg/YoOBSd3Crkfe+UYdUYcvU2hAwE7lkNLq7SQhISuep0nmtudhA9qdwv1ipoDSWFSXn4C7Lw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: ZccputGybKE9MoG' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 5.2) AppleWebKit/538.2.0 (KHTML, like Gecko) Chrome/39.0.845.0 Safari/538.2.0' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TESTPROD_04",
    "amount": {
        "value": "5200000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "ata",
    "beneficiaryAccountName": "Ata",
    "beneficiaryBankCode": "YUKK",
    "sourceAccountNo": "indra69",
    "transactionDate": "2024-10-03T20:50:00+00:00",
    "additionalInfo": {
        "destinationType": "EWALLET_YUKK",
        "urlParam": [
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_RETURN"
            },
            {
                "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
                "type": "PAY_NOTIFY"
            }
        ]
    }
}'

Sample Response

200 OK

Body
Header (10)

    //200 OK
    {
        "responseCode": "2001800",
        "responseMessage": "Successful",
        "referenceNo": "TRD260520204338239",
        "partnerReferenceNo": "TESTPROD_02",
        "amount": {
        "value": "10000.00",
        "currency": "IDR"
        },
        "beneficiaryAccountNo": "ata",
        "beneficiaryBankCode": "YUKK",
        "additionalInfo": {
        "destinationType": "EWALLET_YUKK",
        "urlParam": [
            {
            "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
            "type": "PAY_RETURN"
            },
            {
            "url": "https://webhook.site/b57cd1ea-a7b7-4059-945f-9b6eb7a2b83e",
            "type": "PAY_NOTIFY"
            }
        ],
        "beneficiaryBankName": "YUKK",
        "beneficiaryAccountName": "Ata",
        "feeAmount": {
            "value": "0.00",
            "currency": "IDR"
        },
        "totalAmount": {
            "value": "10000.00",
            "currency": "IDR"
        },
        "redirectUrl": "http://wallet.yukk.local/wallet?ref_id=30b8ff47b9ce817950dd61a68978c8075a618518f54c525cb0e9a333c2e7dc2d"
        }
    }

403 Inactive Account

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4031818",
        "responseMessage": "Inactive Account"
    }

403 Dormant Account

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4031818",
        "responseMessage": "Dormant Account"
    }

409 Duplicate Ref

Body
Header (10)

    //409 CONFLICT R
    {
        "responseCode": "4091801",
        "responseMessage": "Duplicate partnerReferenceNo"
    }

404 Invalid Amount

Body
Header (10)

    //404 NOT FOUND
    {
        "responseCode": "4041813",
        "responseMessage": "Invalid Amount"
    }

403 Exceeds Transaction Amount Limit

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4031812",
        "responseMessage": "Exceeds Transaction Amount Limit"
    }

403 Insufficient Funds

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4031814",
        "responseMessage": "Insufficient Funds"
    }

403 Feature Not Allowed

Body
Header (10)

    //403 FORBIDDEN 
    {
    "responseCode": "4031801",
    "responseMessage": "Feature Not Allowed. No Permission."
    }

404 Transaction Not Permitted

Body
Header (10)

    //404 NOT FOUND
    {
        "responseCode": "4041801",
        "responseMessage": "Transaction Not Permitted. KYC is required."
    }

GET Check Transfer Status
This API is used to actively query the real-time status of an initiated transfer transaction directly from the YUKK gateway.

note

🌐 This API to Interbank Transfer via YUKK
https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/TRD260520204338239

Specification Request

API Name	API Check Transfer Status
Function	to check user’s transfer status
Service Code	00
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/transfer/{referenceNo}

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	(M)	Value always: `application/json`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
responseCode	M	String	Standardized status code. Example value: `2007400`
responseMessage	M	String	Descriptive message. Example value: `Successful`
referenceNo	M	String	Transaction identifier provided by YUKK system. Must be filled upon successful transaction. Example: `2020102977770000000009`
status	M	String	Top up StatusValues: `NEW`, `SUCCESS`
transactionDate	M	String	Transaction date using current timestamp Format: Timestamp
beneficiaryAccountName	M	String	Beneficiary's bank account name
beneficiaryAccountNo	M	String	Beneficiary's bank account number
destinationType	M	String	Destination type. Value: `BANK` or `EWALLET_YUKK`
beneficiaryBankName	M	String	Beneficiary's bank name / source Yukk account ID
amount	M	Object	Billed amount
value	M	Decimal	Billed amount value
currency	M	String	Billed amount currency
feeAmount	M	Object	Fee amount
value	M	Decimal	Fee amount value
currency	M	String	Fee amount currency
totalAmount	M	Object	Total amount
value	M	Decimal	Total amount value
currency	M	String	Total amount currency

Sample Request

200 OK

//200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/TRD260520204338239' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: Qigp02BcsmiNsCe' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.2; Trident/6.1; .NET CLR 1.8.77350.2)' \
--header 'CHANNEL-ID: 00002' \
--data ''

200 OK

//200 OK 
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transfer/TRD260520204338239' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: dVDp/DTcdkRfcR/OmOQuZ7xWK4AhB2LNu7JHICDbSp4hrzjDKNc8iyjTy3xmMPmOOg2JmCImEJqrFHeHK09+VQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: E6X3R0pBJUtxd1l' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 8.0; Windows NT 6.1; Trident/4.0; .NET CLR 1.9.15812.0)' \
--header 'CHANNEL-ID: 00002' \
--data ''

Sample Response

200 OK

Body
Header (10)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "referenceNo": "TRD260520204338239",
        "status": "SUCCESS",
        "transactionDate": "2026-05-20T14:50:35+07:00",
        "beneficiaryAccountName": "Ata",
        "beneficiaryAccountNo": "ata",
        "destinationType": "EWALLET_YUKK",
        "beneficiaryBankName": "YUKK",
        "amount": {
        "value": "10000.00",
        "currency": "IDR"
        },
        "feeAmount": {
        "value": "0.00",
        "currency": "IDR"
        },
        "totalAmount": {
        "value": "10000.00",
        "currency": "IDR"
        }
    }

200 OK

Body
Header (10)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "referenceNo": "TRD260520204338239",
        "status": "SUCCESS",
        "transactionDate": "2026-05-20T14:50:35+07:00",
        "beneficiaryAccountName": "Ata",
        "beneficiaryAccountNo": "ata",
        "destinationType": "EWALLET_YUKK",
        "beneficiaryBankName": "YUKK",
        "amount": {
        "value": "10000.00",
        "currency": "IDR"
        },
        "feeAmount": {
        "value": "0.00",
        "currency": "IDR"
        },
        "totalAmount": {
        "value": "10000.00",
        "currency": "IDR"
        }
    }

Balance & Transaction History

Retrieve a user's YUKK Wallet balance, transaction history, and transaction details.

`POST` Balance Inquiry

This API is used to retrieve the current YUKK Cash balance of a user who has successfully linked their YUKK account to the platform.

note

🌐 This API to Balance Inquiry
https://sandbox.yukk.co/wallet/openapi/v1.0/balance-inquiry

Specification Request

API Name	API Balance Inquiry
Function	to get user's Yukk Cash balance
Service Code	11
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	…/{version}/balance-inquiry

List Specifications & Constraints:

Sort Order: Always returned in descending order (DESC) based on the transaction timestamp.
Maximum Page Size: Maximum allowed pageSize is 50 records per API call.
Maximum Date Range: The range between fromDateTime and toDateTime must not exceed one (1) month.
Oldest Transaction History: The oldest queryable transaction record is strictly limited to one (1) year from the current system date.

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	(M)	Value always: `application/json`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.
User-Agent	String	(M)	Depend on library used

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
partnerReferenceNo	M	String (64)	Unique Partner reference number
balanceTypes	M	List (4)	Balance type. Value: `YUKK_CASH`

Bodyraw(json)

{
    "partnerReferenceNo": "TEST-ASPI_001",
    "balanceTypes": ["YUKK_CASH"]
}

Sample Request

200 OK

//200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/balance-inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: pPgvVERY+xkKA9iVzwzwOVuZHZlj4a1u1BiLk/UvULWS8kpQWe0iay5JZInm5C4uA2exOq0+twmKXYZegURbPA==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: Q8Ej2DDlVpdzoXt' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_9)  AppleWebKit/537.2.0 (KHTML, like Gecko) Chrome/13.0.814.0 Safari/537.2.0' \
--header 'CHANNEL-ID: 00002' \
--header 'User-Agent: insomnia/8.5.1' \
--data '{
    "partnerReferenceNo": "TEST-ASPI_001",
    "balanceTypes": ["YUKK_CASH"]
}'

403 Inactive Account

//403 Inactive Account
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/balance-inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: pPgvVERY+xkKA9iVzwzwOVuZHZlj4a1u1BiLk/UvULWS8kpQWe0iay5JZInm5C4uA2exOq0+twmKXYZegURbPA==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: cjmXORFpVtoDOoc' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.1) AppleWebKit/532.2.2 (KHTML, like Gecko) Chrome/25.0.825.0 Safari/532.2.2' \
--header 'CHANNEL-ID: 00002' \
--header 'User-Agent: insomnia/8.5.1' \
--data '{
    "partnerReferenceNo": "TEST-ASPI_001",
    "balanceTypes": ["YUKK_CASH"]
}'

403 Dormant Account

//403 Dormant Account
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/balance-inquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: pPgvVERY+xkKA9iVzwzwOVuZHZlj4a1u1BiLk/UvULWS8kpQWe0iay5JZInm5C4uA2exOq0+twmKXYZegURbPA==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: RTV2GOsUv_Hkxod' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 5.2; Trident/5.0)' \
--header 'CHANNEL-ID: 00002' \
--header 'User-Agent: insomnia/8.5.1' \
--data '{
    "partnerReferenceNo": "TEST-ASPI_001",
    "balanceTypes": ["YUKK_CASH"]
}'

Sample Response

200 OK

Body
Header (10)

    //200 OK
    {
        "responseCode": "2001100",
        "responseMessage": "Successful",
        "referenceNo": "BI20260520112725",
        "partnerReferenceNo": "TEST-ASPI_001",
        "accountNo": "indra69",
        "name": "Indra",
        "accountInfos": [
        {
            "balanceType": "YUKK_CASH",
            "amount": {
            "value": "298000.00",
            "currency": "IDR"
            }
        }
        ],
        "additionalInfo": {
        "accountType": "PREMIUM"
        }
    }

403 Inactive Account

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4031118",
        "responseMessage": "Inactive Account"
    }

403 Dormant Account

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4031118",
        "responseMessage": "Dormant Account"
    }

`POST` Get Transaction History

This API is used to retrieve a transaction history of a user's YUKK Wallet activities performed through your platform.

note

🌐 This API to Get Transaction History
https://sandbox.yukk.co/wallet/openapi/v1.0/transaction-history-list

Specification Request
Use this API to get user's transaction history list from the wallet & payment activities created on Partner's platform

API Name	API Transaction History List
Function	to get user’s transaction history list from the wallet & payment activities created on Partner’s platform
Service Code	12
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/transaction-history-list

List Specifications & Constraints:

Sort Order: Always returned in descending order (DESC) based on the transaction timestamp.
Maximum Page Size: Maximum allowed pageSize is 50 records per API call.
Maximum Date Range: The range between fromDateTime and toDateTime must not exceed one (1) month.
Oldest Transaction History: The oldest queryable transaction record is strictly limited to one (1) year from the current system date.

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	(M)	Value always: `application/json`.
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-CLIENT-KEY	String	(M)	Your unique integration Client ID.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).
User-Agent	String	(M)	Depend on library used

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
partnerReferenceNo	O	String (64)	Transaction identifier on Partner's system. This will be used as search query.
fromDateTime	O	ISODateTime ISO-8601 (25)	Starting time range. Default: NOW (DESC) E.g: 2019-07-03T12:08:56-07:00
toDateTime	O	ISODateTime ISO-8601 (25)	Ending time range. Default: NOW - 3 months (DESC) E.g: 2019-07-03T12:08:56-07:00
pageSize	O	Int (2)	Max number of transaction returned in one pagination. Default: 10
pageNumber	O	Numeric	Current page number. Default: 1
additionalInfo	O	Object
type	O	Array of Strings	Transaction type: PAYMENT / REFUND / TOP_UP / SEND_MONEY / RECEIVE_MONEY. Default: ALL

Bodyraw(json)

{
    "partnerReferenceNo": "TEST-ASPI_001",
    "pageNumber": 2,
    "pageSize": 10,
    "fromDateTime": "2026-05-01T02:49:15+07:00",
    "toDateTime": "2026-05-21T12:50:00+07:00",
    "additionalInfo": {
        "type": ["PAYMENT", "REFUND", "TOP_UP", "SEND_MONEY", "RECEIVE_MONEY"]
    }
}

Sample Request

200 OK No partnerReferenceNo

//200 OK No partnerReferenceNo
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transaction-history-list' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: IWFAoU1FkH3BKMrRA3llNyucVkViMCe5dHpyz+GR1RVyiSbkvwYJMlk9e9NyUEOjbLsekpMt9QuS1GbVigvj9w==' \
--header 'X-CLIENT-KEY;' \
--header 'X-PARTNER-ID;' \
--header 'X-EXTERNAL-ID: 55U5YEKE6ihbVj9' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:7.9) Gecko/20100101 Firefox/7.9.6' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer ' \
--header 'User-Agent: insomnia/8.5.1' \
--data '{
    "pageNumber": 1,
    "pageSize": 10,
    "fromDateTime": "2026-08-01T23:55:10+07:00",
    "toDateTime": "2026-08-13T04:40:10+07:00",
    "additionalInfo": {
        "type": ["PAYMENT", "REFUND", "TOP_UP", "SEND_MONEY", "RECEIVE_MONEY"]
    }
}'

200 OK With partnerReferenceNo

//200 OK With partnerReferenceNo
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transaction-history-list' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: IWFAoU1FkH3BKMrRA3llNyucVkViMCe5dHpyz+GR1RVyiSbkvwYJMlk9e9NyUEOjbLsekpMt9QuS1GbVigvj9w==' \
--header 'X-CLIENT-KEY;' \
--header 'X-PARTNER-ID;' \
--header 'X-EXTERNAL-ID: Dd7cM8GgJg2JeNL' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 5.3; WOW64; rv:8.9) Gecko/20100101 Firefox/8.9.8' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer ' \
--header 'User-Agent: insomnia/8.5.1' \
--data '{
    "partnerReferenceNo": "TEST_ASPI-129",
    "pageNumber": 1,
    "pageSize": 10,
    "fromDateTime": "2026-08-01T23:55:10+07:00",
    "toDateTime": "2026-08-13T04:40:10+07:00",
    "additionalInfo": {
        "type": ["PAYMENT", "REFUND", "TOP_UP", "SEND_MONEY", "RECEIVE_MONEY"]
    }
}'

200 OK No Trx Match partnerReferenceNo

//200 OK No Trx Match partnerReferenceNo
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transaction-history-list' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: IWFAoU1FkH3BKMrRA3llNyucVkViMCe5dHpyz+GR1RVyiSbkvwYJMlk9e9NyUEOjbLsekpMt9QuS1GbVigvj9w==' \
--header 'X-CLIENT-KEY;' \
--header 'X-PARTNER-ID;' \
--header 'X-EXTERNAL-ID: iiCInuFGNH8WNj6' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.3) AppleWebKit/535.1.0 (KHTML, like Gecko) Chrome/32.0.859.0 Safari/535.1.0' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer ' \
--header 'User-Agent: insomnia/8.5.1' \
--data '{
    "partnerReferenceNo": "xxx",
    "pageNumber": 1,
    "pageSize": 10,
    "fromDateTime": "2026-08-01T23:55:10+07:00",
    "toDateTime": "2026-08-13T04:40:10+07:00",
    "additionalInfo": {
        "type": ["PAYMENT", "REFUND", "TOP_UP", "SEND_MONEY", "RECEIVE_MONEY"]
    }
}'

Sample Response

200 OK No partnerReferenceNo

Body
Headers (12)

//200 OK
{
    "responseCode": "2001200",
    "responseMessage": "Successful",
    "detailData": [
        {
            "dateTime": "2026-08-12T14:54:43+07:00",
            "amount": {
                "value": "101700.00",
                "currency": "IDR"
            },
            "sourceOfFunds": [
                {
                    "source": "YUKK_CASH",
                    "amount": {
                        "value": "101700.00",
                        "currency": "IDR"
                    }
                }
            ],
            "status": "INIT",
            "type": "RECEIVE_MONEY",
            "additionalInfo": {
                "partnerReferenceNo": "TEST_ASPI-390219",
                "referenceNo": "ODE260812862186116",
                "yukkStatus": "PENDING"
            }
        },
        {
            "dateTime": "2026-08-12T14:47:29+07:00",
            "amount": {
                "value": "101700.00",
                "currency": "IDR"
            },
            "sourceOfFunds": [
                {
                "source": "YUKK_CASH",
                "amount": {
                    "value": "101700.00",
                    "currency": "IDR"
                }
                }
            ],
            "status": "INIT",
            "type": "RECEIVE_MONEY",
            "additionalInfo": {
                "partnerReferenceNo": "TEST_ASPI-239321",
                "referenceNo": "ODE260812859728800",
                "yukkStatus": "NEW"
            }
        },
        {
            "dateTime": "2026-08-12T14:42:47+07:00",
            "amount": {
                "value": "101500.00",
                "currency": "IDR"
            },
            "sourceOfFunds": [
                {
                "source": "YUKK_CASH",
                "amount": {
                    "value": "101500.00",
                    "currency": "IDR"
                }
                }
            ],
            "status": "INIT",
            "type": "RECEIVE_MONEY",
            "additionalInfo": {
                "partnerReferenceNo": "TEST_ASPI-9301091",
                "referenceNo": "ODE260812921517262",
                "yukkStatus": "NEW"
            }
        },
        {
            "dateTime": "2026-08-12T14:41:17+07:00",
            "amount": {
                "value": "101700.00",
                "currency": "IDR"
            },
            "sourceOfFunds": [
                {
                "source": "YUKK_CASH",
                "amount": {
                    "value": "101700.00",
                    "currency": "IDR"
                }
                }
            ],
            "status": "INIT",
            "type": "RECEIVE_MONEY",
            "additionalInfo": {
                "partnerReferenceNo": "OKRTU489031",
                "referenceNo": "ODE260812984243074",
                "yukkStatus": "NEW"
            }
        },
        {
            "dateTime": "2026-08-12T14:40:17+07:00",
            "amount": {
                "value": "101700.00",
                "currency": "IDR"
            },
            "sourceOfFunds": [
                {
                "source": "YUKK_CASH",
                "amount": {
                    "value": "101700.00",
                    "currency": "IDR"
                }
                }
            ],
            "status": "INIT",
            "type": "RECEIVE_MONEY",
            "additionalInfo": {
                "partnerReferenceNo": "TEST_ASPI-3920",
                "referenceNo": "ODE260812267749772",
                "yukkStatus": "NEW"
            }
        },
        {
            "dateTime": "2026-08-12T14:38:47+07:00",
            "amount": {
                "value": "101700.00",
                "currency": "IDR"
            },
            "sourceOfFunds": [
                {
                "source": "YUKK_CASH",
                "amount": {
                    "value": "101700.00",
                    "currency": "IDR"
                }
                }
            ],
            "status": "INIT",
            "type": "RECEIVE_MONEY",
            "additionalInfo": {
                "partnerReferenceNo": "TEST_ASPI-1384",
                "referenceNo": "ODE260812793374317",
                "yukkStatus": "NEW"
            }
        },
        {
            "dateTime": "2026-08-11T15:23:45+07:00",
            "amount": {
                "value": "10000.00",
                "currency": "IDR"
            },
            "sourceOfFunds": [
                {
                "source": "YUKK_CASH",
                "amount": {
                    "value": "10000.00",
                    "currency": "IDR"
                }
                }
            ],
            "status": "SUCCESS",
            "type": "PAYMENT",
            "additionalInfo": {
                "partnerReferenceNo": "TEST_ASPI-129",
                "referenceNo": "TRX260811874648528",
                "yukkStatus": "COMPLETED"
            }
        }
    ]
}

200 OK With partnerReferenceNo

Body
Headers (12)

//200 OK
{
    "responseCode": "2001200",
    "responseMessage": "Successful",
    "partnerReferenceNo": "TEST_ASPI-129",
    "referenceNo": "TRX260811874648528",
    "detailData": [
        {
            "dateTime": "2026-08-11T15:23:45+07:00",
            "amount": {
                "value": "10000.00",
                "currency": "IDR"
            },
            "sourceOfFunds": [
                {
                    "source": "YUKK_CASH",
                    "amount": {
                        "value": "10000.00",
                        "currency": "IDR"
                    }
                }
            ],
            "status": "SUCCESS",
            "type": "PAYMENT",
            "additionalInfo": {
                "partnerReferenceNo": "TEST_ASPI-129",
                "referenceNo": "TRX260811874648528",
                "yukkStatus": "COMPLETED"
            }
        }
    ]
}

200 OK No Trx Match partnerReferenceNo

Body
Headers (12)

//200 OK
{
    "responseCode": "2001200",
    "responseMessage": "Successful",
    "partnerReferenceNo": "xxx",
    "referenceNo": "",
    "detailData": []
}

`POST` Get Transaction History Detail

This API is used to retrieve detailed transaction history of a user's YUKK Wallet activities performed through your platform.

note

🌐 This API to Get Transaction History Detail
https://sandbox.yukk.co/wallet/openapi/v1.0/transaction-history-detail

Specification Request

API Name	API Transaction History Detail
Function	to get user’s transaction history list from the wallet & payment activities created on Partner’s platform
Service Code	13
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/transaction-history-detail

Detail Specifications
Data Retention: The transaction details can only be queried for records created within one (1) year from the current system date.

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Content-Type	String	(M)	Value always: `application/json`.
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).
User-Agent	String	(M)	Depend on library used

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
originalPartnerReferenceNo	M	String (64)	Partner’s transaction identifier

Bodyraw(json)

{
    "originalPartnerReferenceNo": "TEST_ASPI-001"
}

Sample Request

200 OK

//200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transaction-history-detail' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: ELJtlRnIhjCzXFGWpRjGdniidRvX9Jh6FdLg08Rbuxu/0br9nYZxlDfjlW8p6WztOws0eQOwnT9YnXkqyhBt4g==' \
--header 'X-PARTNER-ID;' \
--header 'X-EXTERNAL-ID: cCVBP6a4roaZCdf' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.0) AppleWebKit/537.2.1 (KHTML, like Gecko) Chrome/19.0.848.0 Safari/537.2.1' \
--header 'CHANNEL-ID: 0002' \
--header 'Authorization-Customer: Bearer ' \
--header 'User-Agent: insomnia/8.5.1' \
--data '{
    "originalPartnerReferenceNo": "TEST_ASPI-129"
}'

404 Transaction Not Found

//404 Transaction Not Found
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/transaction-history-detail' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: ELJtlRnIhjCzXFGWpRjGdniidRvX9Jh6FdLg08Rbuxu/0br9nYZxlDfjlW8p6WztOws0eQOwnT9YnXkqyhBt4g==' \
--header 'X-PARTNER-ID;' \
--header 'X-EXTERNAL-ID: JeEWDsKl2RaldEC' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 7.0; Windows NT 5.3; Trident/5.1; .NET CLR 2.3.18012.6)' \
--header 'CHANNEL-ID: 0002' \
--header 'Authorization-Customer: Bearer ' \
--header 'User-Agent: insomnia/8.5.1' \
--data '{
    "originalPartnerReferenceNo": "TEST_ASPI-001"
}'

Sample Response

200 OK

Body
Headers (12)

//200 OK
{
    "responseCode": "2001300",
    "responseMessage": "Successful",
    "partnerReferenceNo": "TEST_ASPI-129",
    "referenceNo": "TRX260811874648528",
    "dateTime": "2026-08-11T15:23:45+07:00",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "sourceOfFunds": [
        {
        "source": "YUKK_CASH",
        "amount": {
            "value": "10000.00",
            "currency": "IDR"
        }
        }
    ],
    "status": "SUCCESS",
    "type": "PAYMENT",
    "additionalInfo": {
        "yukkStatus": "COMPLETED"
    }
}

404 Transaction Not Found

Body
Headers (10)

//404 NOT FOUND
{
    "responseCode": "4041301",
    "responseMessage": "Transaction not found."
}

Payment

The Payment provides endpoints to create, check, cancel, and refund Direct Debit transactions.

`POST` Direct Debit

Create a direct debit transaction by submitting the required payment details. Use this endpoint to initiate a debit request from the customer’s linked bank account or payment source.

note

🌐 This API to do Direct Debit
https://sandbox.yukk.co/wallet/openapi/v1.0/debit/payment-host-to-host

Specification Request

API Name	API Direct Debit
Function	to request payment using Yukk Cash balance
Service Code	54
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/debit/payment-host-to-host

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
partnerReferenceNo	M	String (64)	Partner’s transaction identifier
merchantId	M	String (64)
amount	M	Object
value	M	Decimal (16,2)
currency	M	String (3)
urlParam	M	Array of Object
url	M	String (512)
type	M	String (24)
validUpTo	M	String (30)	Format: Timestamp
additionalInfo	O	Object
notes	O	String (250)
refundUpTo	O	String (30)	Format: Timestamp

Bodyraw(json)

{
    "partnerReferenceNo": "TEST_ASPI-008",
    "merchantId": "26",
    "amount": {
        "value": "100000.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        },
        {
            "type": "PAY_RETURN",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        }
    ],
    "validUpTo": "2026-05-22T16:45:05+07:00",
    "additionalInfo": {
        "notes": "Test Remark"
    }
}

Sample Request

200 OK

//200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/payment-host-to-host' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: p6+jEXsyQoU5AyGNfyfSE1ct7/Nmt/cQCWnk1KTD4JPU0vVN4AHOX8HaqeOpNGOhnKbgf68dScuaOonYIeDyaQ==' \
--header 'X-PARTNER-ID: a1ba1e12-0d12-4308-b961-f2a7f1a12345' \
--header 'X-EXTERNAL-ID: AHCXohNqA1hUfFA' \
--header 'X-DEVICE-ID: Opera/13.22 (Windows NT 6.1; U; EO Presto/2.9.170 Version/11.00)' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "partnerReferenceNo": "TEST_ASPI-002",
    "merchantId": "26",
    "amount": {
        "value": "100000.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        },
        {
            "type": "PAY_RETURN",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        }
    ],
    "validUpTo": "2026-05-22T16:45:05+07:00",
    "additionalInfo": {
        "notes": "Test Remark"
    }
}'

409 Duplicate Ref

//409 Duplicate Ref
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/payment-host-to-host' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: p6+jEXsyQoU5AyGNfyfSE1ct7/Nmt/cQCWnk1KTD4JPU0vVN4AHOX8HaqeOpNGOhnKbgf68dScuaOonYIeDyaQ==' \
--header 'X-PARTNER-ID: a1ba1e12-0d12-4308-b961-f2a7f1a12345' \
--header 'X-EXTERNAL-ID: XChwfjyk0o8Q63b' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 5.3; Trident/3.1; .NET CLR 2.0.62517.6)' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "partnerReferenceNo": "TEST_ASPI-003",
    "merchantId": "26",
    "amount": {
        "value": "100000.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        },
        {
            "type": "PAY_RETURN",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        }
    ],
    "validUpTo": "2026-05-22T16:45:05+07:00",
    "additionalInfo": {
        "notes": "Test Remark"
    }
}'

404 Transaction Not Permitted

//404 Transaction Not Permitted
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/payment-host-to-host' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: p6+jEXsyQoU5AyGNfyfSE1ct7/Nmt/cQCWnk1KTD4JPU0vVN4AHOX8HaqeOpNGOhnKbgf68dScuaOonYIeDyaQ==' \
--header 'X-PARTNER-ID: a1ba1e12-0d12-4308-b961-f2a7f1a12345' \
--header 'X-EXTERNAL-ID: ykcQ4dXpzLasyNt' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.1) AppleWebKit/536.1.1 (KHTML, like Gecko) Chrome/31.0.860.0 Safari/536.1.1' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "partnerReferenceNo": "TEST_ASPI-007",
    "merchantId": "26",
    "amount": {
        "value": "100000.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        },
        {
            "type": "PAY_RETURN",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        }
    ],
    "validUpTo": "2026-05-22T16:45:05+07:00",
    "additionalInfo": {
        "notes": "Test Remark"
    }
}'

403 Insufficient Funds

//403 Insufficient Funds
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/payment-host-to-host' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: p6+jEXsyQoU5AyGNfyfSE1ct7/Nmt/cQCWnk1KTD4JPU0vVN4AHOX8HaqeOpNGOhnKbgf68dScuaOonYIeDyaQ==' \
--header 'X-PARTNER-ID: a1ba1e12-0d12-4308-b961-f2a7f1a12345' \
--header 'X-EXTERNAL-ID: 9FwNlcv1FG3Pvce' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:6.1) Gecko/20100101 Firefox/6.1.1' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "partnerReferenceNo": "TEST_ASPI-008",
    "merchantId": "26",
    "amount": {
        "value": "100000.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        },
        {
            "type": "PAY_RETURN",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        }
    ],
    "validUpTo": "2026-05-22T16:45:05+07:00",
    "additionalInfo": {
        "notes": "Test Remark"
    }
}'

403 Exceeds Transaction Amount Limit

//403 Exceeds Transaction Amount Limit
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/payment-host-to-host' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: p6+jEXsyQoU5AyGNfyfSE1ct7/Nmt/cQCWnk1KTD4JPU0vVN4AHOX8HaqeOpNGOhnKbgf68dScuaOonYIeDyaQ==' \
--header 'X-PARTNER-ID: a1ba1e12-0d12-4308-b961-f2a7f1a12345' \
--header 'X-EXTERNAL-ID: 9FwNlcv1FG3Pvce' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:6.1) Gecko/20100101 Firefox/6.1.1' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "partnerReferenceNo": "TEST_ASPI-008",
    "merchantId": "26",
    "amount": {
        "value": "100000.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        },
        {
            "type": "PAY_RETURN",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        }
    ],
    "validUpTo": "2026-05-22T16:45:05+07:00",
    "additionalInfo": {
        "notes": "Test Remark"
    }
}'

403 Feature Not Allowed

//403 Feature Not Allowed
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/payment-host-to-host' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: p6+jEXsyQoU5AyGNfyfSE1ct7/Nmt/cQCWnk1KTD4JPU0vVN4AHOX8HaqeOpNGOhnKbgf68dScuaOonYIeDyaQ==' \
--header 'X-PARTNER-ID: a1ba1e12-0d12-4308-b961-f2a7f1a12345' \
--header 'X-EXTERNAL-ID: bqK0sTJhgaZMVkR' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 5.1) AppleWebKit/534.0.1 (KHTML, like Gecko) Chrome/31.0.874.0 Safari/534.0.1' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "partnerReferenceNo": "TEST_ASPI-008",
    "merchantId": "26",
    "amount": {
        "value": "100000.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        },
        {
            "type": "PAY_RETURN",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        }
    ],
    "validUpTo": "2026-05-22T16:45:05+07:00",
    "additionalInfo": {
        "notes": "Test Remark"
    }
}'

403 Inactive Account

//403 Inactive Account
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/payment-host-to-host' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: p6+jEXsyQoU5AyGNfyfSE1ct7/Nmt/cQCWnk1KTD4JPU0vVN4AHOX8HaqeOpNGOhnKbgf68dScuaOonYIeDyaQ==' \
--header 'X-PARTNER-ID: a1ba1e12-0d12-4308-b961-f2a7f1a12345' \
--header 'X-EXTERNAL-ID: 8O5ahiJ1VDgs_YS' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5.2; rv:11.1) Gecko/20100101 Firefox/11.1.3' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "partnerReferenceNo": "TEST_ASPI-008",
    "merchantId": "26",
    "amount": {
        "value": "100000.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        },
        {
            "type": "PAY_RETURN",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        }
    ],
    "validUpTo": "2026-05-22T16:45:05+07:00",
    "additionalInfo": {
        "notes": "Test Remark"
    }
}'

403 Dormant Account

//403 Dormant Account
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/payment-host-to-host' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: p6+jEXsyQoU5AyGNfyfSE1ct7/Nmt/cQCWnk1KTD4JPU0vVN4AHOX8HaqeOpNGOhnKbgf68dScuaOonYIeDyaQ==' \
--header 'X-PARTNER-ID: a1ba1e12-0d12-4308-b961-f2a7f1a12345' \
--header 'X-EXTERNAL-ID: fwYEog2aGShsZ4K' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_9_3)  AppleWebKit/536.0.1 (KHTML, like Gecko) Chrome/29.0.856.0 Safari/536.0.1' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "partnerReferenceNo": "TEST_ASPI-008",
    "merchantId": "26",
    "amount": {
        "value": "100000.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        },
        {
            "type": "PAY_RETURN",
            "url": "https://yukk.co.id/webhook",
            "isDeeplink": "N"
        }
    ],
    "validUpTo": "2026-05-22T16:45:05+07:00",
    "additionalInfo": {
        "notes": "Test Remark"
    }
}'

Sample Response

200 OK

Body
Header (10)

    //200 OK
    {
        "responseCode": "2005400",
        "responseMessage": "Successful",
        "referenceNo": "TRX260520729310254",
        "partnerReferenceNo": "TEST_ASPI-002",
        "webRedirectUrl": "http://wallet.yukk.local/wallet/direct-payment?ref_id=ZXlKcGRpSTZJblpRTURORWFUVklOakJpYURSSlVrWjZWU3MyYjFFOVBTSXNJblpoYkhWbElqb2lWamxWUWxSbFpqWjBVbXRCTkVSVVRYZHpjMjVHTVdabE5VeENVVkJSV1ZKVVVrSm5ZVUpzU1dWdFpXVjVkM2hHVVZoWk1FcGpaVFIwUm05bFp6VTVLeUlzSW0xaFl5STZJbVl6TVRSaU9HVmtNRFJtTTJSbU5tUmtabUl6T1RnM1pHTTRZVFV5T1daa01ERmxZalUwTUdVeE1XTTBZV00zTTJZek56RXhZV1EwTnpRek5qUXhNR01pZlE9PQ%3D%3D&redirect=https%3A%2F%2Fyukk.co.id%2Fwebhook"
    }

409 Duplicate Ref

Body
Header (10)

    //409 CONFLICT
    {
        "responseCode": "4095401",
        "responseMessage": "Duplicate partnerReferenceNo"
    }

404 Transaction Not Permitted

Body
Header (10)

    //404 NOT FOUND
    {
        "responseCode": "4045401",
        "responseMessage": "Transaction Not Permitted. KYC is required."
    }

403 Insufficient Funds

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4035414",
        "responseMessage": "Insufficient Funds"
    }

403 Exceeds Transaction Amount Limit

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4035412",
        "responseMessage": "Exceeds Transaction Amount Limit"
    }

403 Feature Not Allowed

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4035401",
        "responseMessage": "Feature Not Allowed. No Permission."
    }

403 Inactive Account

Body
Header (10)

    //403 FORBIDDEN 
    {
        "responseCode": "4035418",
        "responseMessage": "Inactive Account"
    }

403 Dormant Account

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4035418",
        "responseMessage": "Dormant Account"
    }

`POST` Direct Debit Status

Use this endpoint to retrieve the latest status of a direct debit transaction using the submitted transaction details.

note

🌐 This API to do Direct Debit Status
https://sandbox.yukk.co/wallet/openapi/v1.0/debit/status

Specification Request

API Name	API Direct Debit Status
Function	to check payment status of Yukk Cash transaction.
Service Code	55
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/debit/status

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
originalPartnerReferenceNo	M	String (64)	Partner’s transaction identifier
serviceCode	M	String (2)

Bodyraw(json)

{
    "originalPartnerReferenceNo": "TEST_ASPI-009",
    "serviceCode": "54"
}

Sample Request

200 OK

//200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/status' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: Rw5R+XUDCHXPqLvMwz/9qjmEaVQz8e4jrduNz2EXFbD4Ds3jUAHg+PT7VA7rtE+GLOObf1xwNXIDKRMu85q/Xw==' \
--header 'X-PARTNER-ID: a1ba1e12-0d12-4308-b961-f2a7f1a12345' \
--header 'X-EXTERNAL-ID: NRjR2i0NHHYX0p5' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.2) AppleWebKit/536.0.0 (KHTML, like Gecko) Chrome/37.0.801.0 Safari/536.0.0' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "TEST_ASPI-002",
    "serviceCode": "54"
}'

200 OK

//200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/status' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: Rw5R+XUDCHXPqLvMwz/9qjmEaVQz8e4jrduNz2EXFbD4Ds3jUAHg+PT7VA7rtE+GLOObf1xwNXIDKRMu85q/Xw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: NSSfA4j_Z9VNQka' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.2) AppleWebKit/536.2.0 (KHTML, like Gecko) Chrome/18.0.852.0 Safari/536.2.0' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "TEST_ASPI-002",
    "serviceCode": "54"
}'

404 Transaction Not Found

//404 Transaction Not Found
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/status' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: JeMB_zJS9CV6fND' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.2; WOW64; rv:11.3) Gecko/20100101 Firefox/11.3.6' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "TEST_YUKK-122323093802",
    "serviceCode": "54"
}'

400 Invalid Service Code

//400 Invalid Service Code
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/status' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: MHlXKFY2wyAGap5' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.2) AppleWebKit/537.1.1 (KHTML, like Gecko) Chrome/20.0.851.0 Safari/537.1.1' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "TEST_YUKK-122323093802",
    "originalReferenceNo": "TRX240815926333152",
    "serviceCode": "5"
}'

Sample Response

200 OK

Body
Header (10)

    //200 OK
    {
        "responseCode": "2005500",
        "responseMessage": "Successful",
        "serviceCode": "54",
        "originalReferenceNo": "TRX260520916430053",
        "originalPartnerReferenceNo": "TEST_ASPI-002",
        "transAmount": {
        "value": "100000.00",
        "currency": "IDR"
        },
        "latestTransactionStatus": "08",
        "transactionStatusDesc": "EXPIRED",
        "paidTime": null,
        "additionalInfo": {
        "sourceOfFunds": [
            {
            "source": "YUKK_CASH",
            "amount": "100000.00"
            }
        ]
        }
    }

200 OK

Body
Header (10)

    //200 OK
    {
        "responseCode": "2005500",
        "responseMessage": "Successful",
        "serviceCode": "54",
        "originalReferenceNo": "TRX260520916430053",
        "originalPartnerReferenceNo": "TEST_ASPI-002",
        "transAmount": {
        "value": "100000.00",
        "currency": "IDR"
        },
        "latestTransactionStatus": "08",
        "transactionStatusDesc": "EXPIRED",
        "paidTime": null,
        "additionalInfo": {
        "sourceOfFunds": [
            {
            "source": "YUKK_CASH",
            "amount": "100000.00"
            }
        ]
        }
    }

404 Transaction Not Found

Body
Header (9)

    //404 NOT FOUND
    {
        "responseCode": "4045501",
        "responseMessage": "Transaction not found."
    }

400 Invalid Service Code

Body
Header (9)

    //400 BAD REQUEST
    {
        "responseCode": "4005502",
        "responseMessage": "Invalid Mandatory Field (serviceCode)"
    }

`POST` Direct Debit Cancel

Use this endpoint to cancel a direct debit transaction by submitting the required transaction details.
Cancel can only be done if payment status = "PENDING",

note

🌐 This API to do Direct Debit Cancel
https://sandbox.yukk.co/wallet/openapi/v1.0/debit/cancel

Specification Request

API Name	API Direct Debit Cancel
Function	to cancel the Yukk Cash transaction.
Service Code	57
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/debit/cancel

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
originalPartnerReferenceNo	M	String (64)	Partner’s transaction identifier

Bodyraw(json)

{
    "originalPartnerReferenceNo": "TEST_ASPI-006"
}

Sample Request

200 OK

//200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/cancel' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: lpTP0r6eG4o8gPy6xHP+dFkCYtEf7hKSMdOq4RS2fV71luCbDfj6OoSdlY/qpAuW8zjiEAg4mCuF1KihRGuZuw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: j_63NeL_tvUHVX1' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.3; Trident/7.0; rv:11.0) like Gecko' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "TEST_ASPI-006"
}'

200 OK

//200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/cancel' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: lpTP0r6eG4o8gPy6xHP+dFkCYtEf7hKSMdOq4RS2fV71luCbDfj6OoSdlY/qpAuW8zjiEAg4mCuF1KihRGuZuw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: _u4EJ5Yz4nWbRhW' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 5.1; Trident/7.0; .NET CLR 3.2.98995.7)' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "TEST_ASPI-006"
}'

403 Feature Not Allowed

//403 Feature Not Allowed
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/cancel' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: lpTP0r6eG4o8gPy6xHP+dFkCYtEf7hKSMdOq4RS2fV71luCbDfj6OoSdlY/qpAuW8zjiEAg4mCuF1KihRGuZuw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: lLLSiw0_ZNjen27' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 5.1; rv:6.8) Gecko/20100101 Firefox/6.8.0' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "TEST_ASPI-002"
}'

403 Feature Not Allowed

//403 Feature Not Allowed
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/cancel' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: lpTP0r6eG4o8gPy6xHP+dFkCYtEf7hKSMdOq4RS2fV71luCbDfj6OoSdlY/qpAuW8zjiEAg4mCuF1KihRGuZuw==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: fWcsEILDNJf82_Q' \
--header 'X-DEVICE-ID: Opera/11.44 (Windows NT 6.0; U; KY Presto/2.9.171 Version/12.00)' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "TEST_ASPI-002"
}'

404 Transaction Not Found

//404 Transaction Not Found
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/cancel' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: p_pNtflcHv8ycFF' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 5.2; Trident/5.1)' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "329032"
}'

Sample Response

200 OK

Body
Header (10)

    //200 OK
    {
        "responseCode": "2005700",
        "responseMessage": "Successful",
        "originalReferenceNo": "TRX260521517406074",
        "originalPartnerReferenceNo": "TEST_ASPI-006",
        "cancelTime": "2026-05-21T12:51:33+07:00"
    }

200 OK

Body
Header (10)

    //200 OK
    {
        "responseCode": "2005700",
        "responseMessage": "Successful",
        "originalReferenceNo": "TRX260521517406074",
        "originalPartnerReferenceNo": "TEST_ASPI-006",
        "cancelTime": "2026-05-21T12:51:33+07:00"
    }

403 Feature Not Allowed

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4035701",
        "responseMessage": "Feature Not Allowed. No Permission."
    }

403 Feature Not Allowed

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4035701",
        "responseMessage": "Feature Not Allowed. No Permission."
    }

404 Transaction Not Found

Body
Header (9)

    //404 NOT FOUND
    {
        "responseCode": "4045701",
        "responseMessage": "Transaction not found."
    }

`POST` Direct Debit Refund

Use this endpoint to submit a refund request for a completed direct debit transaction using the required transaction details.
Refund can only be done if payment status = "PAID", and both transaction's expiry time and autocomplete time are not yet due.

Expiry time is set in API Direct Debit request body validUpTo
Autocomplete time is set in Yukk internal system. Please contact your ACcount Manager for assistance.

note

🌐 This API to do Direct Debit Refund
https://sandbox.yukk.co/wallet/openapi/v1.0/debit/refund

Specification Request

API Name	API Direct Debit Refund
Function	to refund the Yukk Cash transaction.
Service Code	58
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/debit/refund

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
originalPartnerReferenceNo	M	String (64)	Partner’s original transaction identifier to be refunded
partnerRefundNo	M	String (64)	Partner’s refund transaction identifier

Bodyraw(json)

{
    "originalPartnerReferenceNo": "TEST_ASPI-010",
    "partnerRefundNo": "TEST_ASPI-002"
}

Sample Request

200 OK

//200 OK
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/refund' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: XH_FPk9d1O4Qv1f' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 8.0; Windows NT 5.0; Trident/6.1; .NET CLR 2.1.38559.5)' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "ARIF_YUKK-202405140007",
    "partnerRefundNo": "TEST123"
}'

409 Duplicate partnerReferenceNo

//409 Duplicate partnerReferenceNo
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/refund' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: YLRXnHeSm5fVq4R' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 5.2) AppleWebKit/531.1.0 (KHTML, like Gecko) Chrome/36.0.839.0 Safari/531.1.0' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "ARIF_YUKK-202405140007",
    "partnerRefundNo": "TEST123"
}'

404 Transaction Not Found

//404 Transaction Not Found
curl --location 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/refund' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: XlpWwtWZm8rFmsh' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.1) AppleWebKit/538.2.0 (KHTML, like Gecko) Chrome/36.0.821.0 Safari/538.2.0' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "ARIF_YUKK-202405140007",
    "partnerRefundNo": "TEST123"
}'

403 Exceeds Transaction Amount Limit

//403 Exceeds Transaction Amount Limit
curl --location -g 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/refund' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: aerA7GiH2VGnrcdeEqc0iMmVmeISqaCrCemkUEJZyu4/Xta2YHAj8ZKRvtKlWNQyTpVLPP1sUIR8wTLcm51YpA==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: GgshZjMieUkSkAl' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_5_5 rv:5.0; CY) AppleWebKit/531.0.0 (KHTML, like Gecko) Version/7.0.6 Safari/531.0.0' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "TEST_ASPI-002",
    "partnerRefundNo": "TEST_ASPI-002"
}'

403 Exceeds Transaction Amount Limit

//403 Exceeds Transaction Amount Limit
curl --location -g 'https://sandbox.yukk.co/wallet/openapi/v1.0/debit/refund' \
--header 'X-TIMESTAMP: 2025-05-20T09:45:00+07:00' \
--header 'X-SIGNATURE: aerA7GiH2VGnrcdeEqc0iMmVmeISqaCrCemkUEJZyu4/Xta2YHAj8ZKRvtKlWNQyTpVLPP1sUIR8wTLcm51YpA==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: fd1h_0ZaoYS0hsu' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 5.3; Win64; x64; rv:6.4) Gecko/20100101 Firefox/6.4.6' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "TEST_ASPI-002",
    "partnerRefundNo": "TEST_ASPI-002"
}'

Sample Response

200 OK

Body
Header (11)

    //200 OK
    {
        "responseCode": "2005800",
        "responseMessage": "Successful",
        "originalReferenceNo": "TRX240514761256517",
        "originalPartnerReferenceNo": "ARIF_YUKK-202405140007",
        "refundNo": "RFND-240815187299593",
        "partnerRefundNo": "TEST123",
        "refundTime": "2024-08-15T01:49:23+07:00"
    }

409 Duplicate partnerReferenceNo

Body
Header (11)

    //409 CONFLICT
    {
        "responseCode": "4095801",
        "responseMessage": "Duplicate partnerReferenceNo"
    }

404 Transaction Not Found

Body
Header (11)

    //409 CONFLICT
    {
        "responseCode": "4045801",
        "responseMessage": "Transaction not found."
    }

403 Exceeds Transaction Amount Limit

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4035812",
        "responseMessage": "Exceeds Transaction Amount Limit"
    }

403 Exceeds Transaction Amount Limit

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4035812",
        "responseMessage": "Exceeds Transaction Amount Limit"
    }

Pay QRIS

PAY QRIS allows users to make payments by scanning a QRIS code. This section provides endpoints to create, process, and check QRIS payment transactions using the required customer and transaction details.

`POST` API Pay QRIS

Use this endpoint to initiate a PAY QRIS transaction by submitting the required payment and customer details.

note

🌐 This API to request Pay QRIS
{{base_url}}/{{extend_url_wallet}}/api/v1.0/qris/payment

Request this API to launch webview page for user to complete QRIS payment in your application.
The flow is as follows:

Request API Pay QRIS and set up your callback URL in key redirectUrl.
Response will give ref_id (unique reference session id) and webRedirectUrl (webview URL to be embedded in your application).
User will complete QRIS payment in the webview page.
Upon success completion, callback will be sent with params as follows:
- Method: POST
- Data type = multipart/form-data with variables below:
  - ref_id, to match the initially given ref_id.
  - rrn, or referenceNo as a unique identifier that can be used to retrieve QRIS transaction detail in Get Transaction History Detail API .
  - status, QRIS status transaction.

Format callback params:
{redirect}?ref_id={ref_id}?id={id}?status={status}

Specification Request

API Name	API PAY QRIS
Function	to launch webview page for user to complete QRIS payment in your application.
Service Code	00
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/qris/payment

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
Accept	String	(M)	Value always: `application/json`.
Content-Type	String	(M)	Value always: `application/json`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>` (starts with keyword `Bearer` followed by your active B2B2C Access Token).
User-Agent	String	(M)	Depend on library used
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
partnerReferenceNo	M	String (64)	Partner’s transaction identifier
redirectUrl	M	String (255)
notificationUrl	O	String (255)
qrCode	M	Object
type	M	String (8)	QR Code typeValue: `string`
value	M	String (500)	QR Code string value

Bodyraw(json)

{
	"redirect": "https://example.com",
    "qris": "00020101021126660014ID.CO.YUKK.WWW011893600817018000010502152901180000001050303UME51440014ID.CO.QRIS.WWW0215ID20210661264460303UME5204596953033605802ID5911YUKK BRANCH6009TANGERANG61051514362070703A01630441BA",
    "bill_code": "TEST001"
}

Sample Request

API Request

curl --location 'https://sandbox.yukk.co/wallet/api/v1.0/qris/payment' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6IjcxZmRmYzllZjk0NWE3ZDkxOTMxOTlhODllODVmZTBiYTJkNDczZTBiM2E2MTYzYThiYzU1NjZhYzczNmI1OGI2OGNjMWZjOTBhNzdjMDhjIn0.eyJhdWQiOiIxMTIiLCJqdGkiOiI3MWZkZmM5ZWY5NDVhN2Q5MTkzMTk5YTg5ZTg1ZmUwYmEyZDQ3M2UwYjNhNjE2M2E4YmM1NTY2YWM3MzZiNThiNjhjYzFmYzkwYTc3YzA4YyIsImlhdCI6MTY3OTM3MzQ0NSwibmJmIjoxNjc5MzczNDQ1LCJleHAiOjE3MTA5OTU4NDUsInN1YiI6IiIsInNjb3BlcyI6WyJ3YWxsZXQuYmFsYW5jZSIsIndhbGxldC5oaXN0b3J5Iiwid2FsbGV0LnRvcF91cCIsIndhbGxldC50cmFuc2ZlciIsIndhbGxldC5kaXJlY3RfcGF5bWVudCIsIndhbGxldC5kZXBvc2l0Iiwid2FsbGV0LnFyaXMiLCJzb3VyY2Uud2Vic2l0ZSJdfQ.QVheBZ9m0zOEiwnGiVRe5_Zf-sds6Wkkc8AzoUr4Jye7ujCt9OHnTk-jes4oB2kyNCNzGTGjavkN7G0yUxh7pzrhiiu-HvJ0yx2jVYZz9SvfWr2VespiKaYIUY5avt94KSYal90cfsB9FFWoIzHMlp85lQLS7sYeumU_KfwOCM7D5rRhc9A5KlMIcGEmFQXpEhcngCTIv2OJgEWLtrtq_J7F883uVFA52bZa_c0rBNVm3S8DId60E3Xy3q-ezRIFvaTIkEfkEwTk7WbZPldYB4D-BVwN3qbk_CI270UKuAQFOeLoGDX3Jsq1BRt5M22S7kqrf8DkOMj13BVQl5SYdeAX5zvfalqkU8Aw0I5o9OUaDYFN8Tbvxns5IO7oWfXX_w57U7UjDDxbIDPE_UJWtYaz6XIt8kWs8B14XDW5FOLv97TVYHu3HvLOj5fZCEeLq-2k6hgl6S1Zy7nVuUiP5Jwi2049mcfbLlZu56ZTDvhRHEG_y87cVxR_yAFZNAgMB83rTDIUD4tRH4otrqdR-9us9bNFr4r1Br1sc7AbhS5HGzRnf86pZ_S6GyFvQHnuKqAz04LZR8U0PUH6ku98lrCBJBRktYv8PDsB392TVGZyJDG9cgsDWIPU0w06BqS7QFcaX3Us-vRWQy-La2ueXtp9fD5gVWm0uf0ExGquh1c' \
--header 'Token: eyJpdiI6IjA5OUJLVVlTS0l3elRqT1htR2YvRXc9PSIsInZhbHVlIjoiYU1BYVVxSy82VUNwc2h1MkdvV2Q2ZVhZc1p2VzhVOUlQUTdLOXNwL3dCalRLSGUvK1NQenN2eUc4Uy9Tblo4VWY0YW9YYnhybk9ObnphZk1FTGhUd0VWRmI5SVRxR1hsN1ZmZ2x4aWZZWTBHMTVxV3YrRVJoOXRCZ3REZCt1VWhlVTU4M1ZwdkozUjdpVS96OVlIdEEzdTM5cWNYazM2ZUM1TUVvbW1NSCtrQ29GbEFicXFqU0lnNldKZ2UyN0c5QzNWanErc0JsNnZWeUdac0EyTkpXOXBQKzRIdU5HR0FodG9rZE9RNWxCOENYemF4R3lnc1ZRQzRCdC9LekppWEo2STlyQUdIQ3d1TzFaNmFrWDRydXRObUFVN0lQM2VaNTFPeGRXRTJseXZzVWNSeDY0WlhyeEY3bXkzSlFZV1YiLCJtYWMiOiIwNDM5M2QzZDc4ZjU2YmNkZDRmZmUwYjdlZjE0OTVjYmZhNjRmZTYyNzEyMTI5MWQyM2IwOWQwNzg2ZmFhYTBkIiwidGFnIjoiIn0=' \
--data '{
	"redirect": "https://example.com",
    "qris": "00020101021126660014ID.CO.YUKK.WWW011893600817018000010502152901180000001050303UME51440014ID.CO.QRIS.WWW0215ID20210661264460303UME5204596953033605802ID5911YUKK BRANCH6009TANGERANG61051514362070703A01630441BA"
}'

Sample Response

Body
Header (7)

    //200 OK
    {
        "time": 94,
        "status_code": 6000,
        "status_message": "Success! Reference ID created.",
        "result": {
            "id": 10227,
            "ref_id": "XV5XIZYU7Y2VK2IY2107W4JC7XSH0JJYFPVXOUSVSURDX9B0BC77GRKNOC5OWPNBEJ92D1Y6WPJTZVTA80HOR1CGEI4A7SLLBUOPWMWSCGLBBFMJF3875KNJ3STAKFWWAKL67HZJXLV90HTGL2NQMA9Q330NJWKTG50NN07LL2VMKP25RPVE054394RS1C",
            "uri": "https://webapp.yukk.co.id?ref_id=XV5XIZYU7Y2VK2IY2107W4JC7XSH0JJYFPVXOUSVSURDX9B0BC77GRKNOC5OWPNBEJ92D1Y6WPJTZVTA80HOR1CGEI4A7SLLBUOPWMWSCGLBBFMJF3875KNJ3STAKFWWAKL67HZJXLV90HTGL2NQMA9Q330NJWKTG50NN07LL2VMKP25RPVE054394RS1C&id=10227"
        }
    }

Push to Pay

Push-to-Pay allows merchants to send a payment request directly to the customer. This section provides endpoints to create, process, and check the status of Push-to-Pay transactions using the required customer and transaction details.

`POST` Request Push to Pay

Use this endpoint to initiate a Push-to-Pay transaction by sending a payment request with the required customer and transaction details.

note

🌐 This API to request Push to Pay
https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay

Specification Request

API Name	API Request to Pay
Function	to do push to pay transaction by sending payment request
Service Code	00
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/payment/push-to-pay

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
partnerReferenceNo	M	String (64)	Partner’s transaction identifier
phone	M	String (15)
amount	M	Object
value	M	Decimal (16,2)
currency	M	String (3)
urlParam	M	Array of Object
type	M	String (16)
url	M	String (500)
validUpTo	M	String (30)	Format: Timestamp
additionalInfo	O	Object
notes	O	String (250)

Bodyraw(json)

{
    "partnerReferenceNo": "TEST008",
    "phone": "089668058996",
    "amount": {
        "value": "1.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://webhook.site/1b0dada5-6156-4d39-aefe-7446d8e1618f",
            "isDeeplink": "Y"
        }
    ],
    "validUpTo": "2026-05-22T17:24:00+07:00",
    "additionalInfo": {
        "notes": "Test remark"
    }
}

Sample Request

200 OK

//200 OK
curl --location -g 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: A9_8w7XcTEHwsqq' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.1; rv:8.2) Gecko/20100101 Firefox/8.2.7' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TEST006",
    "phone": "089668058996",
    "amount": {
        "value": "1000000.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://webhook.site/1b0dada5-6156-4d39-aefe-7446d8e1618f",
            "isDeeplink": "Y"
        }
    ],
    "validUpTo": "2026-05-22T17:24:00+07:00",
    "additionalInfo": {
        "notes": "Test remark"
    }
}'

409 Duplicate Ref

//409 Duplicate Ref
curl --location -g 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: cv5F8eyyYxcSqeA' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.2; rv:5.8) Gecko/20100101 Firefox/5.8.9' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TEST006",
    "phone": "089668058996",
    "amount": {
        "value": "1.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://webhook.site/1b0dada5-6156-4d39-aefe-7446d8e1618f",
            "isDeeplink": "Y"
        }
    ],
    "validUpTo": "2026-05-22T17:24:00+07:00",
    "additionalInfo": {
        "notes": "Test remark"
    }
}'

404 Transaction Not Permitted

//404 Transaction Not Permitted
curl --location -g 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: um08i6zAGHIFRq5' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 5.3; Win64; x64; rv:15.5) Gecko/20100101 Firefox/15.5.6' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TEST006",
    "phone": "089668058996",
    "amount": {
        "value": "1.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://webhook.site/1b0dada5-6156-4d39-aefe-7446d8e1618f",
            "isDeeplink": "Y"
        }
    ],
    "validUpTo": "2026-05-22T17:24:00+07:00",
    "additionalInfo": {
        "notes": "Test remark"
    }
}'

403 Insufficient Funds

//403 Insufficient Funds
curl --location -g 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: ZrChnI08UeQGsw1' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.8.0; rv:11.6) Gecko/20100101 Firefox/11.6.6' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TEST006",
    "phone": "089668058996",
    "amount": {
        "value": "1.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://webhook.site/1b0dada5-6156-4d39-aefe-7446d8e1618f",
            "isDeeplink": "Y"
        }
    ],
    "validUpTo": "2026-05-22T17:24:00+07:00",
    "additionalInfo": {
        "notes": "Test remark"
    }
}'

404 Invalid Amount

//404 Invalid Amount
curl --location -g 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: 2DBoDx8NmxFEnOR' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.1) AppleWebKit/536.1.1 (KHTML, like Gecko) Chrome/20.0.882.0 Safari/536.1.1' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TEST006",
    "phone": "089668058996",
    "amount": {
        "value": "1.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://webhook.site/1b0dada5-6156-4d39-aefe-7446d8e1618f",
            "isDeeplink": "Y"
        }
    ],
    "validUpTo": "2026-05-22T17:24:00+07:00",
    "additionalInfo": {
        "notes": "Test remark"
    }
}'

403 Feature Not Allowed

//403 Feature Not Allowed
curl --location -g 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: fk1oDQXtDT6VuJC' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:12.2) Gecko/20100101 Firefox/12.2.0' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TEST006",
    "phone": "089668058996",
    "amount": {
        "value": "1.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://webhook.site/1b0dada5-6156-4d39-aefe-7446d8e1618f",
            "isDeeplink": "Y"
        }
    ],
    "validUpTo": "2026-05-22T17:24:00+07:00",
    "additionalInfo": {
        "notes": "Test remark"
    }
}'

403 Exceeds Transaction Amount Limit

//403 Exceeds Transaction Amount Limit
curl --location -g 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: _meQruzzXbEmgV3' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.5.3; rv:5.6) Gecko/20100101 Firefox/5.6.8' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "partnerReferenceNo": "TEST007",
    "phone": "089668058996",
    "amount": {
        "value": "1.00",
        "currency": "IDR"
    },
    "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://webhook.site/1b0dada5-6156-4d39-aefe-7446d8e1618f",
            "isDeeplink": "Y"
        }
    ],
    "validUpTo": "2026-05-22T17:24:00+07:00",
    "additionalInfo": {
        "notes": "Test remark"
    }
}'

Sample Response

200 OK

Body
Header (10)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "partnerReferenceNo": "TEST006",
        "referenceNo": "TRX260521249024544",
        "phone": "089668058996",
        "amount": {
        "value": "1000000.00",
        "currency": "IDR"
        },
        "urlParam": [
        {
            "type": "PAY_NOTIFY",
            "url": "https://webhook.site/1b0dada5-6156-4d39-aefe-7446d8e1618f",
            "isDeeplink": "Y"
        }
        ],
        "validUpTo": "2026-05-22T17:24:00+07:00",
        "additionalInfo": {
        "notes": "Test remark"
        }
    }

409 Duplicate Ref

Body
Header (10)

    //409 CONFLICT 
    {
        "responseCode": "4090001",
        "responseMessage": "Duplicate partnerReferenceNo"
    }

404 Transaction Not Permitted

Body
Header (10)

    //404 NOT FOUND
    {
        "responseCode": "4040001",
        "responseMessage": "Transaction Not Permitted. KYC is required."
    }

403 Insufficient Funds

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4030014",
        "responseMessage": "Insufficient Funds"
    }

404 Invalid Amount

Body
Header (10)

    //404 NOT FOUND
    {
        "responseCode": "4040011",
        "responseMessage": "Invalid Account."
    }

403 Feature Not Allowed

Body
Header (10)

    //403 FORBIDDEN 
    {
        "responseCode": "4030001",
        "responseMessage": "Feature Not Allowed. No Permission."
    }

403 Exceeds Transaction Amount Limit

Body
Header (10)

    //403 FORBIDDEN
    {
        "responseCode": "4030012",
        "responseMessage": "Exceeds Transaction Amount Limit"
    }

`POST` Cancel Payment

Use this endpoint to cancel a Push-to-Pay payment request by submitting the required transaction details.

note

🌐 This API to Cancel Payment
https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay/cancel

Specification Request

API Name	API Cancel Payment
Function	to cancel transaction by submit the transaction
Service Code	00
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/payment/push-to-pay/cancel

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
originalPartnerReferenceNo	M	String (64)	Partner’s original transaction identifier to be cancelled

Bodyraw(json)

{
    "originalPartnerReferenceNo": "TEST005"
}

Sample Request

200 OK

//200 OK
curl --location -g 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay/cancel' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: gzaaqsRhB6Gr2oO' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.2) AppleWebKit/533.0.2 (KHTML, like Gecko) Chrome/28.0.817.0 Safari/533.0.2' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "originalPartnerReferenceNo": "TEST005"
}'

404 Transaction Not Found

//404 Transaction Not Found
curl --location -g 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay/cancel' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: qU3KFiHdjk_TzGu' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.2; Trident/7.0; Touch; rv:11.0) like Gecko' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "originalPartnerReferenceNo": "TEST005x"
}'

200 OK

//200 OK
curl --location -g 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay/cancel' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: SfUAhiPOerji8wi' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; PPC Mac OS X 10_10_1)  AppleWebKit/536.0.2 (KHTML, like Gecko) Chrome/20.0.898.0 Safari/536.0.2' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "originalPartnerReferenceNo": "TEST005"
}'

404 Transaction Not Found

//404 Transaction Not Found
curl --location -g 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay/cancel' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: IwPl5Ab0pUwPyOF' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.0) AppleWebKit/536.0.2 (KHTML, like Gecko) Chrome/14.0.847.0 Safari/536.0.2' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "originalPartnerReferenceNo": "TEST005x"
}'

Sample Response

200 OK

Body
Header (10)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "originalReferenceNo": "TRX260521810964236",
        "originalPartnerReferenceNo": "TEST005",
        "cancelTime": "2026-05-21T13:10:23+07:00"
    }

404 Transaction Not Found

Body
Header (10)

    //404 NOT FOUND
    {
        "responseCode": "4040001",
        "responseMessage": "Transaction not found."
    }

200 OK

Body
Header (10)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "originalReferenceNo": "TRX260521810964236",
        "originalPartnerReferenceNo": "TEST005",
        "cancelTime": "2026-05-21T13:10:23+07:00"
    }

404 Transaction Not Found

Body
Header (10)

    //404 NOT FOUND
    {
        "responseCode": "4040001",
        "responseMessage": "Transaction not found."
    }

`POST` Refund Payment

Use this endpoint to submit a refund request for a completed Push-to-Pay payment using the required transaction details.

note

🌐 This API to Refund Payment
https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay/refund

Specification Request

API Name	API Refund Payment
Function	to refund transaction by submit the transaction
Service Code	00
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/payment/push-to-pay/refund

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
originalPartnerReferenceNo	M	String (64)	Partner’s original transaction identifier to be refunded
partnerRefundNo	M	String (64)	Partner’s refund transaction identifier

Bodyraw(json)

{
    "originalPartnerReferenceNo": "TEST006",
    "partnerRefundNo": "TEST-RFND-0001"
}

Sample Request

200 OK

//200 OK
curl --location -g 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay/refund' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: girnNjPRJRNI4TX' \
--header 'X-DEVICE-ID: Mozilla/5.0 (compatible; MSIE 8.0; Windows NT 6.2; Trident/6.0; .NET CLR 2.9.19212.9)' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "originalPartnerReferenceNo": "TEST008",
    "partnerRefundNo": "TEST-RFND-0001"
}'

404 Transaction Not Found

//404 Transaction Not Found
curl --location -g 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay/refund' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: MXtyvIH7OtGY6Is' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_7_8 rv:2.0; SL) AppleWebKit/532.0.1 (KHTML, like Gecko) Version/5.1.3 Safari/532.0.1' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "originalPartnerReferenceNo": "TEST008",
    "partnerRefundNo": "TEST-RFND-0001"
}'

409 Duplicate Ref

//409 Duplicate Ref
curl --location -g 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay/refund' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: y3qFD0cuwfpJ6fV' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 5.3) AppleWebKit/535.0.2 (KHTML, like Gecko) Chrome/31.0.872.0 Safari/535.0.2' \
--header 'CHANNEL-ID: 00002' \
--data '{
    "originalPartnerReferenceNo": "TEST006",
    "partnerRefundNo": "TEST-RFND-0001"
}'

Sample Response

200 OK

Body
Header (10)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "originalReferenceNo": "TRX260521910550280",
        "originalPartnerReferenceNo": "TEST008",
        "refundNo": "RFND-260521776111346",
        "partnerRefundNo": "TEST-RFND-0001",
        "refundTime": "2026-05-21T13:20:14+07:00"
    }

404 Transaction Not Found

Body
Header (10)

    //404 NOT FOUND
    {
        "responseCode": "4040001",
        "responseMessage": "Transaction not found."
    }

409 Duplicate Ref

Body
Header (10)

    //409 CONFLICT
    {
        "responseCode": "4090001",
        "responseMessage": "Duplicate partnerReferenceNo"
    }

`POST` Check Payment

Use this endpoint to retrieve the latest payment status of a Push-to-Pay transaction using the required transaction details.

note

🌐 This API to Check Payment
https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay/status

Specification Request

API Name	API Check Payment
Function	to check transaction by submit the transaction
Service Code	00
Version	1.0
HTTP Method	POST
Base URL (Staging)	https://sandbox.yukk.co/
Base URL (Production)	https://api.yukk.co/
Endpoint URL	.../{version}/payment/push-to-pay/status

Request Headers
The following table is a header of request parameter:

Field	Type	Attributes	Description
X-TIMESTAMP	String	(M)	Local transaction timestamp in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSTZD, e.g., 2025-05-20T09:45:00+07:00).
X-SIGNATURE	String	(M)	Asymmetric signature generated using your Private Key. Formula: SHA256withRSA(Private_Key, stringToSign) where stringToSign = client_ID + "\|" + X-TIMESTAMP.
X-PARTNER-ID	String (36)	(M)	Unique integration Client ID.
X-EXTERNAL-ID	String (36)	(M)	Unique random transaction tracking reference string (e.g., F2Wwt5b3nE_2o89).
X-DEVICE-ID	String (400)	(M)	User hardware/software agent identification.
CHANNEL-ID	String (5)	(M)	Value always: `00002`.
Authorization-Customer	String	(M)	Customer-level authorization token format: `Bearer <accessToken>`

Request Body
The following table is a body of request parameter:

Field	Attribute (MOC)	Type	Description
originalPartnerReferenceNo	C	String (64)	Partner’s transaction identifier. Choose either to check transaction payment using `originalPartnerReferenceNo` OR `originalReferenceNo`
originalReferenceNo	C	String (64)	Partner’s refund transaction identifier. Choose either to check transaction payment using `originalPartnerReferenceNo` OR `originalReferenceNo`

Bodyraw(json)

{
    "originalPartnerReferenceNo": "TEST001",
    "originalReferenceNo": "POE123456789123"
}

Sample Request

200 OK

//200 OK
curl --location 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay/status' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: h8KYg1Yg7lWcQDy' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 5.1) AppleWebKit/535.2.1 (KHTML, like Gecko) Chrome/27.0.883.0 Safari/535.2.1' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "TEST001",
    "originalReferenceNo": "POE123456789123"
}'

200 OK

//200 OK
curl --location 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay/status' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: Id5SRGo1uuhfTjc' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 6.2; Trident/7.0; rv:11.0) like Gecko' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "TEST001"
}'

200 OK

//200 OK
curl --location 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay/status' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: CX2qTgqO1jhHyBe' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.3) AppleWebKit/538.2.0 (KHTML, like Gecko) Chrome/39.0.869.0 Safari/538.2.0' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalReferenceNo": "POE123456789123"
}'

400 Invalid Mandatory Field

//400 Invalid Mandatory Field
curl --location 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay/status' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: xESuoyQiTuPBGr1' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows; U; Windows NT 6.2) AppleWebKit/533.1.1 (KHTML, like Gecko) Chrome/16.0.889.0 Safari/533.1.1' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "foo": "POE123456789123"
}'

404 Transaction Not Found

//404 Transaction Not Found
curl --location 'https://sandbox.yukk.co/wallet/api/v1.0/payment/push-to-pay/status' \
--header 'X-TIMESTAMP: 2024-03-07T09:45:00+07:00' \
--header 'X-SIGNATURE: J9m3ZPcfcN2JYlg+7r2GyQhvkuBVy39bvCWPfX6hNxU8qAPw49/MRjNv7h1ZzkiiDqW9WpsjkGEgYXQnwiRBnQ==' \
--header 'X-PARTNER-ID: a7e1535f-df4b-3c28-bdb3-ef48a53463a4' \
--header 'X-EXTERNAL-ID: 6sH276RA11ljzjt' \
--header 'X-DEVICE-ID: Mozilla/5.0 (Windows NT 5.1; WOW64; rv:11.4) Gecko/20100101 Firefox/11.4.7' \
--header 'CHANNEL-ID: 00002' \
--header 'Authorization-Customer: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiJhMWJhN2U3Mi0wZDk0LTQzMDgtYjk2MS1mMmE3ZjFhMDgwNjgiLCJqdGkiOiJjYjZlM2ZkZGZmNmI0MDUxMGJiNTg4M2IyNzE4Nzg5OTc3MDhjMWMwN2IyMzAzMzkzYjU1NGIzNzg4NmM3NDExYzc3NzI5MjkzZGU3ABClMCIsImlhdCI6MTc4NDYxNDQ2My40MjEzMTMsIm5iZiI6MTc4NDYxNDQ2My40MjEzMTgsImV4cCI6MTc4NTkxMDQ2My40MDg4NDMsInN1YiI6Ijk0NCIsInNjb3BlcyI6W119.p8fkajqqs6JYf7xmCjXBp8pk-umc93TibbrtMHw09N7jEMOpranSAzEUO7Q--tIToTco7kjInKlli8n7LGc_kUiCFTEP9kcS_yDEPekALogvrssh5cUxnojrWBJQpGLajzY1tN8On_6CHr-sKLNMvoNOB6Lp4EIy85h6uqoR1yMH6GKQoFFbUa-eoOwrjtvIasJ-xhPkxR_nr5PqNdvB6aN8nBWv3bWr8GHaj96UlAaAcHtuoRNq-fNpRn6S5-lmlTqvHZaCDoBSrTVxvHCg0JySNNG_0Euqt4LpCTgRf0fve5sH68D3ifIa1t_zzlzjBf4WkDFRHUN4ADYTQXq_fqNxGkSktMIAUoIrW1xyCBClzNXFMCGf74vTWYvtZuCkT5I0g2qNzoE534zPtwaTY-KnKun9rXTxKgZJD-STna7lrbxjVT_JqAhCFwwlEatui6raMKzNU09C9dFnwV-wTHlNGN3dO8_NT936K1DPj5LL2LGdH69-hY04bfbZouR0D3Z2VokJI8Pbe3kYQN-qWUWjaiBLZq1Z3AslXTnAfVhFSbYPtDt5h2smiBznb_XSdUDITa8V_FhJth6csoY9xhyo5YEn1S2epsOGCwTLcKupobeBtNI6RUCz5g7oaca_kAQRZJLHFbNRACoGa1-CRGSdLnTA2bJuhFI7MQ-aBCd' \
--data '{
    "originalPartnerReferenceNo": "POE123456789123"
}'

Sample Response

200 OK

Body
Header (1)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "originalReferenceNo": "TRX250220355420488",
        "originalPartnerReferenceNo": "TEST005",
        "transAmount": {
        "value": "1.00",
        "currency": "IDR"
        },
        "latestTransactionStatus": "03",
        "transactionStatusDesc": "PENDING",
        "paidTime": null,
        "additionalInfo": {
        "sourceOfFunds": [
            {
            "source": "YUKK_CASH",
            "amount": "1.00"
            }
        ],
        "phone": "089668058996",
        "expiryTime": "2025-02-21T17:24:00+07:00",
        "notes": "Test remark"
        }
    }

200 OK

Body
Header (1)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "originalReferenceNo": "TRX250220355420488",
        "originalPartnerReferenceNo": "TEST005",
        "transAmount": {
        "value": "1.00",
        "currency": "IDR"
        },
        "latestTransactionStatus": "03",
        "transactionStatusDesc": "PENDING",
        "paidTime": null,
        "additionalInfo": {
        "sourceOfFunds": [
            {
            "source": "YUKK_CASH",
            "amount": "1.00"
            }
        ],
        "phone": "089668058996",
        "expiryTime": "2025-02-21T17:24:00+07:00",
        "notes": "Test remark"
        }
    }

200 OK

Body
Header (1)

    //200 OK
    {
        "responseCode": "2000000",
        "responseMessage": "Successful",
        "originalReferenceNo": "TRX250220355420488",
        "originalPartnerReferenceNo": "TEST005",
        "transAmount": {
        "value": "1.00",
        "currency": "IDR"
        },
        "latestTransactionStatus": "03",
        "transactionStatusDesc": "PENDING",
        "paidTime": null,
        "additionalInfo": {
        "sourceOfFunds": [
            {
            "source": "YUKK_CASH",
            "amount": "1.00"
            }
        ],
        "phone": "089668058996",
        "expiryTime": "2025-02-21T17:24:00+07:00",
        "notes": "Test remark"
        }
    }

400 Invalid Mandatory Field

Body
Header (1)

    //400 BAD REQUEST
    {
        "responseCode": "4000002",
        "responseMessage": "Invalid Mandatory Field (originalReferenceNo)"
    }

404 Transaction Not Found

Body
Header (1)

    //404 NOT FOUND
    {
        "responseCode": "4040001",
        "responseMessage": "Transaction not found."
    }

Date	Tue, 19 May 2026 13:50:45 GMT
Server	Apache/2.4.66 (Debian)
X-TIMESTAMP	2025-05-20T09:45:00+07:00
X-CLIENT-KEY	015bf836-d6ac-4f5e-a745-a891b95edb46
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	57
Keep Alive	timeout=5, max=100
Connection	keep-alive
Transfer Encoding	chunked
Content-Type	application/json

Date	Tue, 19 May 2026 13:54:27 GMT
Server	Apache/2.4.66 (Debian)
X-TIMESTAMP	2025-05-20T09:45:00+07:00
X-CLIENT-KEY	somerandomclient
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	58
Keep Alive	timeout=5, max=100
Connection	keep-alive
Transfer Encoding	chunked
Content-Type	application/json

Date	Tue, 19 May 2026 14:01:23 GMT
Server	Apache/2.4.66 (Debian)
X-TIMESTAMP	2025-05-20T09:45:00+07:00
X-CLIENT-KEY	015bf836-d6ac-4f5e-a745-a891b95edb46
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	59
Keep Alive	timeout=5, max=100
Connection	keep-alive
Transfer Encoding	chunked
Content-Type	application/json

Date	Tue, 19 May 2026 14:12:52 GMT
Server	Apache/2.4.66 (Debian)
X-TIMESTAMP	2025-05-20T09:45:00+07:00
X-CLIENT-KEY	015bf836-d6ac-4f5e-a745-a891b95edb46
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	58
Connection	close
Transfer Encoding	chunked
Content-Type	application/json

Date	Tue, 19 May 2026 13:50:45 GMT
Server	Apache/2.4.66 (Debian)
X-TIMESTAMP	2025-05-20T09:45:00+07:00
X-CLIENT-KEY	015bf836-d6ac-4f5e-a745-a891b95edb46
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	59
Connection	close
Transfer Encoding	chunked
Content-Type	application/json

Date	Tue, 19 May 2026 14:17:48 GMT
Server	Apache/2.4.66 (Debian)
X-TIMESTAMP	2025-05-20T09:45:00+07:00
X-CLIENT-KEY	015bf836-d6ac-4f5e-a745-a891b95edb46
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	59
Connection	close
Transfer Encoding	chunked
Content-Type	application/json

Date	Wed, 20 May 2026 03:33:14 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	60
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	keep-alive
Transfer Encoding	chunked
Content-Type	application/json

Date	Thu, 21 May 2026 07:06:18 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	58
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	keep-alive
Transfer Encoding	chunked
Content-Type	application/json

Date	Thu, 21 May 2026 07:38:40 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	59
Vary	Authorization
Keep Alive	timeout=5, max=100
Connection	keep-alive
Transfer Encoding	chunked
Content-Type	application/json

Date	Thu, 21 May 2026 08:15:10 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	59
Vary	Authorization
Keep Alive	timeout=5, max=100
Connection	keep-alive
Transfer Encoding	chunked
Content-Type	application/json

Date	Thu, 21 May 2026 08:27:04 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	60
Vary	Authorization
Keep Alive	timeout=5, max=100
Connection	keep-alive
Transfer Encoding	chunked
Content-Type	application/json

Date	Thu, 21 May 2026 08:26:33 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	57
Vary	Authorization
Keep Alive	timeout=5, max=100
Connection	keep-alive
Transfer Encoding	chunked
Content-Type	application/json

Date	Tue, 19 May 2026 15:02:07 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
Set-Cookie	XSRF-TOKEN=eyJpdiI6ImVkdkt0RjFVRDJraVU1dVdqTThVSEE9PSIsInZhbHVlIjoiNmVNSjljRnVrdWNEVXRNU04wOUZONkNjUUdNT2VVTm5sc0c2Uzh0MGxpQ3BQRTRJdkQ2TnZGMDdwbzE2WTU4enkwQk4wbnNuTFQwWW4rSm4ySk9LUXBSNE0yVzN0aDRJTXgwSEk0ek9aQUwxeE04K0RBdWtoTlZQSGRQaWlpUnUiLCJtYWMiOiJlMDk0YWEzMDNkMTFjNjQ1ZTAzMWIyNTc2MDEzNzI3ZWVlYmE5YzBhNDNmMDI1OGRlZWZjZGI2ODU2MjVhNDA4IiwidGFnIjoiIn0%3D; expires=Tue, 19 May 2026 17:02:07 GMT; Max-Age=7200; path=/; samesite=lax
Set-Cookie	laravel_session=eyJpdiI6Ijg1Z0JRcEJWUkVsS3ZNcURhVDVIR1E9PSIsInZhbHVlIjoic3NvZktnL0l0N0VaL1lWdTkxZlJxUFlTMzVIcTV2V2p5cDJyVkJPV1luYWJMQzkxUTFXWXJaSENpdWJCOXRtVWxJUXhTaHBXK0M3Y2xIUnBIa3laRG91U3I1c0oxQTR1TXFadk5EamhSL1lETFk3aVd1dWVxV2xTVjBVdVhlTnAiLCJtYWMiOiI0NzAxZWY0OTE0ZjU0N2FhNWQ1NjRlY2I3ZTc2ZmU0MjIzZjEzMjZhMTVkNzgwZDU1NTlmMjdkNDIyZWMxNjdmIiwidGFnIjoiIn0%3D; expires=Tue, 19 May 2026 17:02:07 GMT; Max-Age=7200; path=/; httponly; samesite=lax
Vary	Accept-Encoding
Content-Encoding	grip
Content-Length	16588
Keep-Alive	timeout=5, max=99
Connection	keep-alive
Content-Type	text/html; charset=UTF-8

Date	Tue, 19 May 2026 16:08:32 GMT
Server	Apache/2.4.66 (Debian)
X-TIMESTAMP	2025-05-20T09:45:00+07:00
X-CLIENT-KEY	015bf836-d6ac-4f5e-a745-a891b95edb46
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	59
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Tue, 19 May 2026 16:09:41 GMT
Server	Apache/2.4.66 (Debian)
X-TIMESTAMP	2025-05-20T09:45:00+07:00
X-CLIENT-KEY	015bf836-d6ac-4f5e-a745-a891b95edb46
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	58
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Wed, 20 May 2026 20:37:22 GMT
Server	Apache/2.4.66 (Debian)
X-TIMESTAMP	2025-05-20T09:45:00+07:00
X-CLIENT-KEY	015bf836-d6ac-4f5e-a745-a891b95edb46
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	59
Vary	Authorization
Connection	close
Transfer-Encoding	chunked
Content-Type	application/json

Date	Wed, 20 May 2026 04:40:10 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	59
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Server	nginx
Date	Sun, 22 Sep 2024 18:36:59 GMT
Content-Type	application/json
Transfer-Encoding	chunked
Connection	Keep-Alive
X-Powered-By	PHP/8.3.8
Cache-Control	private, must-revalidate
pragma	no-cache
expires	-1
X-RateLimit-Limit	60
X-RateLimit-Remaining	59
X-Frame-Options	SAMEORIGIN
X-Content-Type-Options	nosniff
X-XSS-Protection	1; mode=block

Date	Wed, 20 May 2026 07:08:45 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	58
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Wed, 20 May 2026 20:47:18 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	59
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Wed, 20 May 2026 20:47:55 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	58
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Wed, 20 May 2026 20:48:57 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	59
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Wed, 20 May 2026 20:49:47 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	56
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Wed, 20 May 2026 20:50:51 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	57
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Wed, 20 May 2026 20:52:58 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	58
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Introduction​

Definition of Wallet & Payment​

Purpose of the Integration​

Base URL​

Authentication for YUKK Wallet​

Access Token B2B​

Account​

Account Registration & Binding API Overview​

Account Creation via API​

OTP Service​

Verify OTP​

Webhook Notify User Status​

Account Creation & Binding via WEB​

Account Unbinding​

POST Account Unbinding​

Wallet​

Top up​

Transfer​

Balance & Transaction History​

POST Balance Inquiry​

POST Get Transaction History​

POST Get Transaction History Detail​

Payment​

POST Direct Debit​

POST Direct Debit Status​

POST Direct Debit Cancel​

POST Direct Debit Refund​

Pay QRIS​

POST API Pay QRIS​

Push to Pay​

POST Request Push to Pay​

POST Cancel Payment​

POST Refund Payment​

POST Check Payment​

Introduction

Definition of Wallet & Payment

Purpose of the Integration

Base URL

Authentication for YUKK Wallet

Access Token B2B

Account

Account Registration & Binding API Overview

Account Creation via API

OTP Service

Verify OTP

Webhook Notify User Status

Account Creation & Binding via WEB

Account Unbinding

`POST` Account Unbinding

Wallet

Top up

Transfer

Balance & Transaction History

`POST` Balance Inquiry

`POST` Get Transaction History

`POST` Get Transaction History Detail

Payment

`POST` Direct Debit

`POST` Direct Debit Status

`POST` Direct Debit Cancel

`POST` Direct Debit Refund

Pay QRIS

`POST` API Pay QRIS

Push to Pay

`POST` Request Push to Pay

`POST` Cancel Payment

`POST` Refund Payment

`POST` Check Payment

Date	Thu, 21 May 2026 01:03:29 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	56
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Wed, 20 May 2026 07:19:40 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	59
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Wed, 20 May 2026 21:00:05 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	58
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Thu, 21 May 2026 00:57:54 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	59
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Thu, 21 May 2026 00:58:23 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	58
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Thu, 21 May 2026 00:58:58 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	59
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Thu, 21 May 2026 00:59:24 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	58
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Thu, 21 May 2026 01:00:29 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	58
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Thu, 21 May 2026 01:01:32 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	57
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json

Date	Thu, 21 May 2026 01:03:02 GMT
Server	Apache/2.4.66 (Debian)
Cache-Control	no-cache, private
X-RateLimit-Limit	60
X-RateLimit-Remaining	57
Vary	Authorization
Keep-Alive	timeout=5, max=100
Connection	Keep-Alive
Transfer-Encoding	chunked
Content-Type	application/json