Question | Answer |
---|---|
What are the requirements for staging credentials creation? |
|
What kind of credential that partner get from OVO ? |
Partner will get :
|
For migration activity , If partner already do integration top up non SNAP with OVO, can partner use existing client-id? | Yes, Partner can use client-id existing for run API in both staging and production environment |
Question | Answer |
---|---|
What are the requirements for production credentials creation? |
|
For migration activity, if partner used existing clientid, is there any procedure that partner need to config ? | Yes, if partner used existing clientid, the expiry token need to set up into 15 mins as per BI requirement (for non SNAP the default its 8 hours). If partner used any scheduler or service to automate token generate, it must be changed into less than 15 mins. |
Question | Answer |
---|---|
How many test that partner need to do for the BI submission test? | There are 2 testing, which is Devsite Testing and Functionality Testing |
How partner can get the credentials/Account to do the Devsite Testing? | Partner can sign up directly in the BI SNAP Portal https://apidevportal.bi.go.id/snap/ |
If partner facing inactive app info in BI website, is there any way to reactivate it? |
Click 'request extend' in right side. And wait around 2-5 days (please confirm to BI Team for timeline to approve) Inactive means that account still not get approval from BI/ASPI, for fastest response partner can ask to BI/ASPI Team. |
How many scenario that need to run for Devsite Testing? |
There will 2 scenario (Positive and Negative) for each the below API: api/v1.0/emoney/account-inquiry (API Inquiry Phone number) api/v1.0/emoney/topup (API Top Up) api/v1.0/emoney/topup-status (API Check Top Up Status) So in total partner need to run 6 scenario. |
What partner need to do when already done for the Devsite testing and what document that partner need to send to OVO team? |
After finished the Devsite Testing, partner can download the results from the BI Portal then partner can send the .pdf document to OVO team through email to [email protected]. For the testing guidance please refer to the google drive shared in "Devsite Testing Video" folder |
When the partner can perform the BI Submission Test? | Partner can perform the Devsite test once the integration has started & can perform the Functional Test during the development phase. It can be done simultaneously |
What are the partner need to fill in the functionality testing results document? |
Partner only need to fill in the Request and Response column with the partner full backend log include the header (cURL), below for the example: Request:
"--header 'X-PARTNER-ID: oamerchantd' \
Response:
{
|
For functional test, does the partner only need to fill table Request & Response? |
Yes, partner only need to fill column Request & Response.
Please do not change another value since it will be submit to BI (regulator)
|
To whom partner will submit the Devsite & Funtionality Test result? | The test result of Devsite Test & Functionalit Test can be submit thru email to [email protected] with cc the OVO Business team. After thus OVO will submission this document with compliance team |
If partner want to go the next step in integration (UAT) do partner have to wait until got the approval from BI? | No, partner don't need to wait due to the verification from BI can do it in paralel. |
For partner under the PG, do partner need to submit to OVO the for all the BI submission testing? | For connection OVO - PG - partner, it's only need 1 times submission to BI . So for the integration between PG and the partner under PG, it will handle by PG it self. |
Question | Answer |
---|---|
Is there any dedicated account for test in stage environment? | No, partner will use their own OVO stage account. |
How to request the account in stage | 1. For the OVO stage apps download invitation ( https://forms.gle/fb7k75ypWyZrnfr37 ) *notes: - For registration, it will perform by userself thru OVO stage apps - Only allow Indonesian mobile number - The OTP is using 4 last digit phone number |
Are the OVO stage apps support for Android & iOS? | Yes |
Is it allowed for foreign phone number? | Currently only allowed for Indonesian phone number |
User can't open the download link of OVO stage apps | Please ensure the account that use for receive the invitation is a google base (for Android) & login into the Google Playstore or Apple Store using the same account |
Will OVO send the OTP? | No |
How to get the OTP code? | In stage, the OTP use the last 4 digit number of the OVO stage account |
What need to be input during security PIN challange? | During registration in OVO staging apps, a new user will be asking for create a security PIN code. |
User getting stuck on verification page | User can double tap on the midle of the mobile screen apps |
Question | Answer |
---|---|
What is the client-ID & key for running the API? | The client-ID & the secret key will be share by OVO to partner as credential to run the api. note : The client-id & key will be different for stage & production environment |
How to generate the public key & how to decrypted the key? | Please refer to file Client Credential Sharing SOP & the Additional Guidance file |
Question | Answer |
---|---|
What is the client-ID & key for running the API? |
If Partner used deposit method below is mandatory :
|
Question | Answer |
---|---|
Signature generation classification for each API |
Asymetric
*this signature used SHA256withRSA to generate the signature with your Private Key as the key but for stringTosign please use HTTPMethod + ”:“+ EndpointUrl + Lowercase(HexEncode(SHA-256(minify(RequestBody)))) + ":“ + TimeStamp Symetric
|
Question | Answer |
---|---|
How many token will be use for this integration & what is the usage? | Its only 1 token for all api : systemToken/b2b_accessToken : Will get the token after call the OVOSNAP/v1.0/access-token/b2b. |
What is the expiry of token? | systemToken/b2b_accessToken : 15 minutes |
Does the partner is required to keep the token? | Yes, partner need to keep the access token & also all backend log for all API |
Question | Answer |
---|---|
How to get postman collection and environment for snap top up api | Partner can refer to url link : https://drive.google.com/drive/folders/1vmuT7bRG96HUHbGqr-NL6r_sFaC_7eOl (please ask OVO Team for grant access) and download 2 file below : |
How to run this collection in Postman ? | Partner can refer to url link : https://drive.google.com/drive/folders/1vmuT7bRG96HUHbGqr-NL6r_sFaC_7eOl (please ask OVO Team for grant access) and find folder 'Postman Video' for demo how to run all api |
Question | Answer |
---|---|
What function of this API ? | This API used for generate access token (b2b) |
Can partner generate token everytime we call Inquiry/Top Up API ? | Not recommended to call System Token (B2B) every time transaction happen. Partner should call generate token after get expired (15 mins) |
How to check this token expiry? | Partner can check the value expiresIn at the response log after hit this api. It measure in second format. Ex : expiresIn : 900 (it means token expired in 900s/15 mins) |
What response will be show when token expired ? | Partner will get this response below :
{ |
Can partner customize token expired? | Currently token expired is based on BI requirement, hence partner can't customize token expiry. |
Since the value of parameter CLIENT-KEY & PARTNER-ID is same, why on API Get Access Token using parameter as CLIENT-KEY ? | Because it's based on BI Requirement in BI SNAP Technical Document |
Question | Answer |
---|---|
What phone number that used for this API ? | Customer OVO account/phone number |
Partner get regeneratePayment when hit inquiry number API, what its mean? | RegeneratePayment means partner token expired/not valid. Partner need to generate new token |
Is there any type data or standarization of partnerReferenceNo? | Following the standard of BI SNAP Tech Doc use String type data |
Is there any expiration time between API Account inquiry number to Customer Top Up | Currently no |
Is there any limitation to call the inquiry API for 1 OVO account number? How many times? | Currently no |
Is there any impact if partner didn't do inquiry before hit the Topup API? | The Top Up will fail, and partner will get "responseMessage": "Transaction Not Permitted" |
There is value partnerReferenceNo in body, how long is the maximum length? | max 64 digit following BI standard SNAP Tech doc |
Who will generate partnerReferenceNo? | Partner side and it should be unique number |
Question | Answer |
---|---|
Can customer use other country number for Top Up ? | No, currently only allowed for Indonesian phone number |
How to generate partnerReferenceNo? | partnerReferenceNo should be the same based on the account inquiry api response |
Is there any limit amount can be receive by customer? | for maximum top up its depend on OVO account membership. Maximum balance Club Account : Rp2.000.000,- Maximum balance Premier Account : Rp20.000.000,- for max incoming transaction limit a month : Maximum balance Club Account : Rp20.000.000,- Maximum balance Premier Account : Rp40.000.000,- for Minimum Top Up its depend on business agreement Partner with OVO |
Is there any timeout to get the response? If yes, how long? | Yes, its 30s. But, partner will get real time response immediately |
What is the workaorund if partner didn't get a response within 30s? | If partner didnt receive any response from top up api within 30s, partner need to hit check top up status to get latestTransactionStatus . |
How partner will get the response? | Partner will get real time response immediately after hit Top Up API. |
Question | Answer |
---|---|
When the Inquiry Transaction Status will be used? | Partner can hit ideally after call top up payment. |
Does the parameter "Service Code" always use value as 38? | yes, 38 its specifically for Top Up Api |
What its mean of response latestTransactionStatus "01" (Initiated) when partner do top up inquiry status? | OVO only receive the customer inquiry api call from partner, but the Top Up API call is never made (or it is made but never reaches or processed by OVO). The transaction will be failed, and OVO will not retry |
What Partner needs to do when get latestTransactionStatus "01" (Initiated) when partner do top up inquiry status ? | Partner can hit another top up |
Is there any limitation period to check transaction status? | Partner can check transaction status, up to 1 week after hit transaction |
What is the meaning of latestTransactionStatus = pending ? | Transaction is still on progress, it can be updated to success or failed within the same day |
Question | Answer |
---|---|
When Partner call this api? | Partner can hit this api anytime when partner want to check the deposit balance |
How to top up Partner balance deposit? | Partner need to perform transfer deposit into the bank account that is stated in the OVO system, once done Partner can send the receipt of the transfer to [email protected], after it the funds will be adjusted within D+2 WH (on normal condition). To expedite process of fund adjustemenr, please contact the PIC of OVO Business Team. |
What will happen if Partner balance deposit is insufficient ? | The Top Up payment will failed, on the backend will getting responseCode 500xx00 |