Overview
Xendit collects payments for 9Pic Checkout across several Southeast Asian currencies. Add one Xendit configuration for your organisation, then assign it to the event that will sell packages. You need a secret key from the Xendit Dashboard. Xendit issues a development secret key while you test and a separate production secret key for real payments.
Before You Start
Get Your Xendit Secret Key
1
Open API Keys in Xendit
Sign in to the Xendit Dashboard and open the API Keys page.
2
Copy the secret key for the mode you need
Copy the secret key for the environment you are working in. Xendit’s own convention starts development keys with
xnd_development_ and production keys with xnd_production_.3
Store the key safely
Keep the key in your organisation’s approved password manager until you add it to 9Pic. Do not paste it into a buyer-facing website or app.
Need help finding the keys in Xendit? Check the Xendit Dashboard’s API Keys page directly, or contact the Xendit team that provisioned your merchant account.
Add Xendit to 9Pic
1
Open Payment Config
In the dashboard sidebar, select Payment Config.
2
Start a new gateway
In Payment Gateway Configurations, click Add Gateway, then select Xendit.
3
Name the configuration
Enter an optional Label that makes the configuration easy to recognise, such as
Xendit Test or Xendit Live Indonesia.4
Enter an optional Account ID
Account ID is optional for Xendit. Use it only if your team wants a reminder of which Xendit account the key belongs to.
5
Enter the secret key
Paste the key into Xendit Secret Key. This required value is stored as a protected credential for your organisation.
6
Create the gateway
Click Create Gateway. The new Xendit configuration appears in the organisation’s gateway list.
Assign Xendit to an Event
1
Open the event Checkout configuration
Open the event, then open its Checkout configuration.
2
Assign the Xendit configuration
In the Payment gateway card, select Assign (or Edit if a gateway is already assigned), choose the Xendit configuration, and save.
3
Set package prices in a supported currency
Create or update Checkout packages in IDR, PHP, MYR, THB, or VND. Other currencies cannot be used with Xendit.
4
Publish and test
Publish the packages and run a complete buyer journey with a development-key configuration before you switch the event to a production key.
Xendit does not offer a Pass on fees option in 9Pic Checkout. The listed package price is always the amount charged.
Verify the Setup
Troubleshooting
9Pic says the Xendit secret key is not configured.
9Pic says the Xendit secret key is not configured.
Edit the Xendit configuration in Payment Config and confirm that Xendit Secret Key has a value. Then assign that configuration on the event’s Payment gateway card.
A development key was used for a public event and I want to prevent that.
A development key was used for a public event and I want to prevent that.
9Pic does not block a development secret key from being used in production for Xendit. Review the configuration’s key before publishing packages for a public event, and replace it with a production key when you are ready to accept real payments.
I cannot select my currency, or another currency is blocked.
I cannot select my currency, or another currency is blocked.
Events assigned to Xendit can only sell IDR, PHP, MYR, THB, or VND packages. Choose one of those currencies, or assign a gateway that supports the currency you need.
The buyer does not see the payment method I expected.
The buyer does not see the payment method I expected.
9Pic does not send a fixed list of payment methods to Xendit. The buyer sees whatever payment methods are enabled on your Xendit account. Enable the method in Xendit, then retry a test purchase.
I expected a Pass on fees option like PayMongo has.
I expected a Pass on fees option like PayMongo has.
Xendit does not support passing provider fees on to buyers in 9Pic Checkout. The listed package price is always the amount charged.
Next Steps
Payment Config
Manage the payment gateways saved for your organisation.
Checkout Setup
Assign a gateway, publish packages, and enable Checkout for an event.