Skip to main content

Integration Procedures

Integration Information​

Environments​

MoMo provides two environments to integrate with the MoMo API:

  • Test: Used during the integration and testing process: building features, testing, debugging, etc.
  • Production: Used to deploy to End-users.

Credentials​

These keys are essential for integrating with the MoMo API. For each environment, the keys will be different.

  • Partner Code: Your business account’s unique identity.
  • Access Key: Server Access key.
  • Secret Key: Used to create digital signature.
  • Public Key: Used to encrypt data by RSA algorithm.

[Find your keys]

M4b_flow

Configuration HTTP Request​

KeyValue
Content-Typeapplication/json; charset=UTF-8
MethodPOST
DomainProduction: https://payment.momo.vn
Sandbox: https://test-payment.momo.vn

Internet Protocol​

EnvironmentIncomingOutcoming
Sandbox210.245.113.71118.69.210.244
118.68.171.198
Production118.69.212.158118.69.210.244
116.103.110.134 (New Update from 11 Sep 2024)

Timeout config​

The minimum timeout when calling all API must be 30s to ensure receiving a response from MoMo. Exclude path: /v2/gateway/api/tokenization/pay is 10s

Technical Integration Process​

After completing your M4B registration and choosing our Payment Solution(s), you can immediately* start integrating with our API. The process is made to be seamless yet solid as follows:

  • Step 1: Integrate with our Payment Solution(s) on the Test environment.
  • Step 2: Conduct testing on the Test environment, and share the results with MoMo for review and assistance if needed.
  • Step 3: Complete the requirements for verification with your M4B account and request MoMo for Production credentials.
  • Step 4: Conduct UAT in Production, you can refer to our common test cases. Once completed, share the results with MoMo for review and assistance if needed. MoMo will notify you if your service is good to go.
  • Step 5: Deploy MoMo Payment Solution(s) to your customers.

*For Automated Payments flow, you are required to fill our Tokenization Evaluation Form to start testing on both environments. For more information please contact MoMo.

MoMo's Transaction ID​

MoMo Transaction ID (TID/transId) is a number generated by MoMo to identify a partner's transaction. This TID is unique on MoMo system.

Partner's Transaction ID​

Partner Transaction ID (orderId/billId) is a unique string and identifies a partner's transaction sent to MoMo to request for payment. Each orderId/billId will correspond to a TID. Note that orderId/billId can be custom by requirement but must be adapt the rule below:

  • Unguessable.
  • Not too long (refer below 64 bytes).
  • Not reference to any sensitive information, especially customer info.
ON THIS PAGE