Go live: from the checklist to your first real payment

What you will do

Your Live account starts pending: live keys return 403 live_mode_not_activated and live payment links take no payments. VEXPay approves live mode after reviewing your business and your integration. This playbook takes you through every step, in order.

• Your integration already works in Test (see Test everything first).
• Your company documents at hand: registration deed, tax ID certificate, the legal representative's ID and a proof of address (PDF, PNG or JPEG, up to 10 MB each).

Complete the Getting started checklist

The portal Overview shows a Getting started checklist. Work through it on your Live account:

1. 01
   Add your contact info

   Save the owner email and phone when the portal asks. They are private: never shown to buyers or sent in the API. Until they are saved, the portal refuses to create, rotate or reveal any key, and refuses go-live (409 owner_contact_required).

2. 02
   Verify your identity or business

   Open Verification and choose who is selling. A company: company details, business activity, the legal representative and beneficial owners (25% or more), the PEP declaration and attestations; documents are the registration deed, tax ID certificate, representative ID and proof of address. Myself (you sell under your own name or a firma personal): your ID details, personal RIF or tax ID, home address, business activity and attestations; documents are your ID, a selfie holding that ID (PNG or JPEG), your personal RIF certificate and proof of address, plus the firma personal registration if you have one. Submit when nothing is missing. You can edit it while it is a draft or when VEXPay requests changes (their note is shown).

3. 03
   Get your API credentials

   Have at least one active key in Credentials. Live keys can be created once live mode is approved; until then, use Test.

4. 04
   Add a webhook endpoint

   At least one active endpoint in Webhooks. See Set up webhooks.

5. 05
   Save and verify your payout account

   Save a Pago Móvil payout account in Payouts and confirm the two micro-deposits, or save a USDT wallet in USDT (usable 24 hours after saving). See Withdraw your balance.

6. 06
   Marketplaces: register and verify a seller

   Marketplace accounts also register their first seller and verify one seller payout destination. See Onboard a seller.

Request go-live

1. 01
   Finish one test payment and one webhook delivery

   VEXPay reviews your Test account for at least one completed payment and one successful webhook delivery.

2. 02
   Click Request go-live

   On the Live portal, click Request go-live on the "Live mode pending review" banner. The banner then shows that review was requested. The button does not work from the Test portal.

3. 03
   Send a short video of your integration

   VEXPay asks for a short video of your integration working end to end (a buyer paying and your system reacting). Send it on WhatsApp to +58 414 933 3844 (wa.me/584149333844) with your account name. Approval waits until it has been reviewed.

4. 04
   Wait for approval

   Approval needs your business verification to be approved and your owner contact saved. When live mode is approved you receive the tenant.live_status_changed webhook and the banner disappears.

Switch to live

1. 01
   Create a live key

   With Live selected, open Credentials and create a key. Store it in your production environment.

2. 02
   Register production webhooks on Live

   Live and Test have separate endpoints and secrets. Register your production URL on the Live account and store its secret.

3. 03
   Deploy and make one small real payment

   Deploy with the live key, pay a small real amount, and check it end to end.

curl "${API_URL}/v1/banks" \
  --header "x-api-key: ${VEXPAY_API_KEY}"
# 200 = live mode active · 403 live_mode_not_activated = not approved yet

Check that it worked

• GET /v1/banks with the live key returns 200.
• Your first real payment is COMPLETED, and its payment.completed webhook has livemode: true.
• Live bolívar credits show in unconfirmedVes on GET /v1/balance until the bank confirms them, then become available and are settled to your payout account automatically every 15 minutes.

If something goes wrong

Related: Going live · Authentication · Seller or marketplace