USD Card Acceptance API

🚧

Account configuration is required before live transactions

We need to configure your account before you can start accepting live payments. Kindly message [email protected] to request for key configuration. Your account's eligibility will be reviewed before you can access this feature

Our USD Card Acceptance feature is now available on Custom API! This feature enables the acceptance of USD Card payments from international cards, allowing you to tap into international markets and expand your audience. Your customers will not be charged with the interchange fees. Furthermore, PayMongo’s USD Card Acceptance simplifies conversions from USD to PHP - our partner bank will process the foreign exchange for you, making it possible to accept payments from a foreign currency while receiving the funds in your local currency.

Common use cases include e-commerce platforms that sell products on a global scale, resorts & travel agencies that accept bookings from non-domestic locations, service providers with international clients, overseas Filipino workers looking to invest in properties back home, and educational institutions with international students. The great thing about this feature is that there is only one minor change that needs to be made to your existing custom API code.

Integrating USD Card Acceptance through the Payment Intent Workflow

Making the change to accept USD payments is easy! When you first made your custom website's payment intent flow by following the steps in our Payment Intent Workflow, you had to perform all the 5 steps. You will only need to edit the first step of the Payment Intent Workflow to start enjoying USD card payments.

1. Set the Currency attribute to USD in the Create a PaymentIntent step
   You may follow the sample code block below for the change that you will need to implement to integrate USD payments for your card transactions.

   {
     "data": {
       "attributes": {
         "amount": 10000,
         "payment_method_allowed": [
           "card"
         ],
         "payment_method_options": {
           "card": {
             "request_three_d_secure": "any"
           }
         },
         "currency": "USD",
         "capture_type": "automatic",
         "description": "Your internal description",
         "statement_descriptor": "Your statement descriptor"
       }
     }
   }
   

Test Mode Support

You can test out your USD payments by switching to Test Mode on your PayMongo Dashboard, and use these test cards.