Foreign Exchange (FX) Rate Inquiry
HTTPS POST / Server-to-Server
Payment requests and responses are encrypted using JWE
- JWE algorithm = RSA-OAEP + A256GCM
- The signature uses JWS PS256
Merchants must know how to prepare requests and process responses using JWT with exchange key.
https://demo2.2c2p.com/2C2PFrontend/PaymentAction/2.0/action
https://t.2c2p.com/PaymentAction/2.0/action
FX Rate Inquiry Request
To prepare an FX rate inquiry request, refer to the guidelines below.
Provided Sample Code
The following sample code demonstrates how to prepare request data, generate the JWT token with key, and send the API request.
For the JWT token, you may also refer to the sample code here.
- To prepare the data payload for the FX rate inquiry request, refer to the sample structure shown below. You may also check the API specifications here: FX Rate Inquiry Request Parameters
<FxRateRequest>
<version>2.1</version>
<timeStamp>180321162445</timeStamp>
<merchantID>JT</merchantID>
<currency>702</currency>
</FxRateRequest>
2.To generate encrypted request data, refer to this guide: Generate JWT Request with Keys
- To send the encrypted request via API, refer to the sample request below.
eyJhbGciOiJQUzI1NiIsInR5cCI6IkpXVCJ9.ZXlKaGJHY2lPaUpTVTBFdFQwRkZVQ0lzSW1WdVl5STZJa0V5TlRaSFEwMGlmUS5SWU4zck0yRVNjSXI5OXZqc1BWdC1xZ3pTR0JCMC1LV1U1LWdyZS1vMGJjWnM0dlJQeWtFYVp6amRod3NnV3FJX3JjOUlPWFQtMkJBaFdiZm80V3BWTjJXZ2JXY052Qjc1c3BDU0VVb1ZkQjlKbDdWSnhVRVJMQ1ZRazRpdG9TWWxJd1dzclZMOXRvLXFEdFhkSEl4RDExMG5idlA4SUtDUkhZUUI4V0szbnhaU1pjc3hvRTRDeXVkQkFhWXBrVkNaMEYxZ0RoM1JLa19UMEl2eXhzZklWbzdTa0RhWkxkcW5DZk0wRjBIM1pYajF2VlNQTzVmbkR0cENMMEx4RGFucDNNVmtQOHRqVzhWZmpoSl9sZGYwUEctdTVRM2NqRWhHT0lnTVdlb0pYZmx2amlta3g5TVlDOVhUV3RTcVdleGFtVUJHdFpOZ0pSdkV1THlDcHZ0Z1EuYW5jcm8xMTgxUzl2ck9sWi5GdEJBUTBEX1FEVThacnptSWFRajNXb3A3dnJQX0htM0xoVnJtS1d2dlp5SnJWSnNISk1pYVNoOElNVC1xVk5jSldpNU5wMU5sY0M5dTRCRzd1em43aXNiWXBNcUFLOE9SN2xxcEpsRTVJQmpRR1VURmdudkZ0VlNUbFRHRTNMUkZlNmNoVDVEZ3l3U3hFX3ZQYTRVQzFFbWl3empVT0oybHRpYnpaOXFjRi1Jc1NWWHhRbndDZlJjeGEwYm5XbjdWTzlac2VGa2hZSHVOZDNscFotWjE5ak13YUxfUVhVWXQxOXVxMGJjVE5YQWE4VUtJUFh4ZUhsUmJkaVk2RXdnalJDYXlyQzJHVDFmMmcuVFVSS0dyamFPYm1GSWpMVjBzRWpjZw.eSIdOTFLbclxbzUAEZo-h7ykX6evCJA2IKmUoZyDSFFZWCb6wLI3FLd4bTjAXZVxtUpKFiq38ktOCz3gNkYePPqV6uXkmD9da5tLpqg4GbKmCIv91rwntW8UbW7BH0DleYUbne3rAIMyTChgcRbThMXS9O7W6k3AB9AkprOXw5C6GB01e0qccY93gWCbHapwBSpQkqlTSulV_pXp8duv7xLRDUdvWaXgoEmJbVnSymgjDJs0sIKzfzKtns6SUWRwoGceWhUEUy3bPOwuHXtOXGU8klQO_bWMHkTTKIVxDMIU040sMPjB24NPG_dlBBbG_3rx9YU4URjLBh4z7Tiq4g
FX Rate Inquiry Response
To receive and process FX rate inquiry request responses, refer to the sample code below.
Provided Sample Code
The following sample code demonstrates how to receive response data and decrypt the JWT token with key.
For decrypting the JWT token, you may also refer to the sample code here.
- Following an FX rate inquiry request, the API will return encrypted response data. Refer to the sample encrypted response below.
eyJhbGciOiJQUzI1NiIsInR5cCI6IkpXVCJ9.ZXlKaGJHY2lPaUpTVTBFdFQwRkZVQ0lzSW1WdVl5STZJa0V5TlRaSFEwMGlmUS5HTXF0Z0lOcUYyd0otalpRRGw1eUhDYTRTbDMxNVJ5QmpLOG1BYy1FNWdkVDRZVzB0ajBSUlVqM19ENDVBcktkeE92MTJpaW03d2NvbDNkaWd5cURabFowWC1FVGpYN0tXYV9aZl9CazdwREZoNzB5RlR3cmZ4NGxVX3hvVjUyYl9pd1dreldzemhXLXBCcktidlo0cnVxUEpvZWpURTlUVllxc0RiVmhqVkVvX2dqeUgxTnQ0U08xS0s0a2huVjVVMDZlb3BsdFZxdXhrVGJWaWlPTk1FeGt0VE55V3FHcXVQMGhWd1RyRExqWDgyMlpzbDZxYTJHd0FOd3ZvMHlIZWlDU05sTm9pU0hDeWdkeE5CQkZTZDRCZzNOYzNrOC00c2R0S1h0TVdkREdReGRldEtqWFpTc2d4bV8xc2VHT2RLVTluMHo4Mnc5MWhFVndjTXM2OWcucjB6cW5vYnFCcEpmaXBBWC5ialloQjh5R2pfdmNjY2FiWmFOU0pWNTVpa2wtYTNxZlM1bHZKVU55dUxBVEZnWVM2M1A4S2E0VFpwdnlTdTJhZUdnU1JJcUE5eFhDLVBINlVRaGNvb1VGQWRSWEdwaGVrS01sSnJaOFJ0SENoUXNnN3U1Q0VsN0xRWk0yY2NLOVRPQm8zSFVPRE0zQUxEaENCSXdFd3NNNDBNZzRaR1AwSHM5WlRVRklRS0x2Q25pVWdhMFNWZ3NST0pEcGdlUnNBWVF4TWJ5Mnh3bDhPTHUxZElZclNKaFV0SzlpM29QMDBfRFcxTU91TW94Vy1qdlpGbnVnTkhLT29zNlRMSUhDU0hnVnJYX2ZjYW9qXzZlTmJpU09xQ0RWeHpkemJRbEYtTHM2U2prZk1QTTVfNDY3SUNudFB4ZTRQSkVpRUZ2TU5IbTFORmlEclFIcjQ3VzdiVlExcWR0VlFvNDZVTXo4WnA0elo3NE56UlhxVXlGQXdVWmJYcnFJY3VKb015N05kUlFyZjV2ZzA5ZklidFUyMXowWFg4ZGx1SzBySXJQcTRzcUdLbmU1MmNBVm5BLlNIRldqUHM5dElxZDU5anRoM2tqU2c.m8Bd5cvOT--93fsldrv7z_M8183B3fgYPQgTNeJcviNceHaTLT1R7EOeTYfnxDtN2avw356HPPXoR75vTBPTkbccfAuD66CkTe83D6DhKmaYLBOmFiO_YYmGD1LRTf3QmfkzWa2ZH_h91CcW4Xvzkv_ZdPsheaiiNi5Tbb6OjQGwQ4Sw7ogomTx_HOoggAJZcaRTkNvsb-fWud2a-HFUhnZg4Kt-UqRE1BJwFVRefe27VkRJuijqM7e2CIFryO-7a0PptIPXG0HBWoFwnSLhxT0lT6ndtKKxJDyyr299AMY6QLX6PoS0fmZRSQa8ebJUJgwS1iGGEHVALapwhTEDbA
-
To decrypt the response, refer to: Process JWT Request with Keys
-
Refer to the sample response structure below. You may also check the API specifications here: FX Rate Inquiry Response Parameters
<FxRateResponse>
<version>2.1</version>
<timeStamp>180321162445</timeStamp>
<merchantID>JT</merchantID>
<currency>702</currency>
<fxRate>1.0000</fxRate>
<baseCurrency>702</baseCurrency>
<responseCode>00</responseCode>
<respReason>Success</respReason>
</FxRateResponse>
FX Rate List Inquiry Request
To prepare an FX rate list inquiry request, refer to the guidelines below.
Provided Sample Code
The following sample code demonstrates how to prepare request data, generate the JWT token with key, and send the API request.
For the JWT token, you may also refer to the sample code here.
- To prepare the data payload for the FX rate list inquiry request, refer to the sample structure shown below. You may also check the API specifications here: FX Rate List Inquiry Request Parameter
<FxRateListRequest>
<version>2.1</version>
<timeStamp>070222084005</timeStamp>
<merchantID>JT</merchantID>
<hashValue>22B47EA9A54A6BE7D4243C993F84EBBA55CC5AD8</hashValue>
</FxRateListRequest>
2.To generate encrypted request data, refer to this guide: Generate JWT Request with Keys
- To send the encrypted request via API, refer to the sample request below.
eyJhbGciOiJQUzI1NiIsImtpZCI6ImRlZmF1bHQifQ.ZXlKaGJHY2lPaUpTVTBFdFQwRkZVQ0lzSW1WdVl5STZJa0V5TlRaSFEwMGlmUS5NcTFmTkZQREZ2ZUthSUd2ZTM0WmsweGR6MC02MHYxd3JFT3R6eDNWYWc1TldGLVpRdE5uNDhiQzRxTzNGdl9nQ1lfX1FFUWlnNkxYdXpxXzFELV91SENIRUtUTk1ZTGJTS0NPSmtEWmRRc3h6Wm83ZlhzRWRuRmRjYjVsc2NUdzVYOUIta0FURXVnNXBDR1R0b1VReGxJakpRRTIySjZCZDNTUE1OOFlnM3lHNzhmcDlVVHJVZ1hmZEFZSVNEUGd5LUVURzJsNkZJM1ZMQWhDZk1tdWJQU3NuVW9XcE8ycE4xZGk3WXZYeEZRckQ4a2MxVXJDUGVoTDA5dGt5VGtkaEpWVWY0c3lTWHpRS2hnaWlfY3NDOHQzNkV6eENpM2lEM1JXWjdfemE2ZjFpYzEyWDAzc3JlOWZEdkg0cjlpVnVsN25hMlRIQk5kSDdrUVVPeW1TMXcuaWZEb2hERWtmREZNSC1YNi5KV05EN0tNUGlkeEQ2WC1NcTJKQUNWWUtsbzdNYnd0anVaaWxOay1SY1lXbmt1WUtTcDR2Yl9kRjhCUGQ4aFFoVnJacnMtenFZVU1pbHRsbURnMG9tR19OR2pVeG4tcm1QVXREVWhGalJoUDJHcElKUDdid3ZrMC04WUE2OUJ2Qkp3b25vQk5qcU9hMFlWd3ZVYnl2TGxBWVUtcDEwanlrR1JFeTJnd284ZlRfS29ybVA4WWZPeHNtQ1hNSVJ0VUR6bXk1Rzh2R2Y1TV9ac1NRTXFSR3M5MW9oNnIzdTl3RkZ3aWN1UzNwN1NBd0tmOWd3dWpyZTJDVi5QQ2dYbEJNMFU3dkhwNWxkTTJmcnJ3.o_U6lYsbbNbWsnX2iTu3j0aPPv_QKhyOUs990UNMGv_NPcQakM9jsgJWRKuy8nVUmQpDyqW-hHWIbJ52ZM7W3uez_qD78wTZF81Xogu2TovdPfBf65m9zU-sRJIRA2DKCd4ztft7SHxgx0u7YPOqbEHlMCVOmA7LrLRVM_vZq5caMi1evCHEoIsK33ijtHPZJHyXtZ-xJXEZItrf_t2qD0sN2sqxMbBsbbyIg20Y0zBAv8BsIMRsrIVvqkg3s2RgD9pHqByTrDp9Yb7I78N-Exj1pyiDdvgCrUzfSZ-DlXXEFVYToP-LyhADbHbDbfNDlTCPsinPhgvYRZ0VmBHfww
FX Rate List Inquiry Response
To receive and process FX rate list inquiry request responses, refer to the sample code below.
Provided Sample Code
The following sample code demonstrates how to receive response data and decrypt the JWT token with key.
For decrypting the JWT token, you may also refer to the sample code here.
- Following an FX rate list inquiry request, the API will return encrypted response data. Refer to the sample encrypted response below.
eyJhbGciOiJQUzI1NiIsImtpZCI6IjIifQ.ZXlKaGJHY2lPaUpTVTBFdFQwRkZVQ0lzSW1WdVl5STZJa0V5TlRaSFEwMGlMQ0pyYVdRaU9pSWlmUS5YLU5CSDBIUVdIQUpGd3FDMzlsSXN1NGp5SXp2NE5pUXNJQVo3MDdfdkxXVkk5S3ZMRk1qTWJubzMtNXBEQ1paRW1LdWJqVFFJVDNtMlY1RURhcWp6cS03a0VSY3JqRkRkMVI0MkU1UlJ1dEF5OHNWdTN6aWtId0VGcVpuYUh1dWtkMVFoVk1DMjZoWEVyOGxKd2REM25vcHJHNko5bWg5LTJSLUlPbXZNYXl5aFpodENhUDl6eGxCa3ZETE1peEplM3RaWWZ1Y1FPQzk2a0RPblYtOHU3YkhURzloMG92djZIVXk3cUxxdDhOTl9oakVsd3hXcTBaalBpUnZwVVpoQXE5SGlWajFfWGpNM0lSdmUyWTVJZUZVdXlKVG83TGpGd3lPTUppd1h1YTNRZFotSTNfR2VsbTZjSFg2ZzNNRHgyMkxhOXM2SE1aUHFiWDVfQ2JQUWcuYThGbVlIT2hUaHlUblpJZy45djNRTVFvMUR1Y3pxYjVIY1VDNmlaMEVlLVRLd3dobXd3VW96bm9reFg3UV83MHpSYzFndzRnSWNucXVheHpocjc4NkhLdk03Q1RqX0tNZnVCVGd1cC1qcy1ZNm0xbzJzdFc2MXAyb3RIclE5TnZ3bnJSVmgzM05JRENLSmFyVV80SEZnSmRwZ2hDcTR2alNWYkl6b3VqaDY4LVJhVlZmTU1rcXVXcS1wa3Y3eF9XQVhDZnVzbDE4Y2ktRzZvSVMxVlU5ZV94ejlfRkd0X1hYN0NCcnBEZVhTR1laeXdiUGRkMjJJVjZadi1sNUFxdkdtdHJkTTNEcHB0RDFUOFZXNjZnLWlQSGJkSHZyZk10SFBTUEJTS2J1ZmZKeDlBZlZaMGNpYk1rbERXOWpOZGxEMlc1NGpGRzlyZXY4QkJpanU1ckhoOVFTdWZEOEZ6OTJDb3JJOWgtdnQzWUtTdnpaMTlEVFVLQVFaYmtGOE5GZFBwODEtZjZJdVFjRlRvM2RJY1ZEZEtUQTFJNkdhcTFIMWM3bEVzcGFtWFJwYmx0NTNFaWFtWjdSMjN3NVFXQVNwRlRLNjUzUlVqb090eGcwbEVNbXhhVnl6Nm9IVmtiYmVYWHhQU1ZDZ2VBakl5YzBpd0tCU1c0UlluUzBJWUtnREV5S3Z6MXMwRlBaN2hDOTg1dk5hcWFnaWI0Y2NKNFR2aDh5U29yRF9mcWJkUGk1eFVXRUhYeWI0Z3FhejN5UHF0WGQ1UmxYMmFCR3hVcFRMQlNLZDgyZl9DNXM0YzdiUmdTVUxhTWJmTlphb1VPVGhJWjhIYVdNODVHZkR6YTM2R1E4TDdyVHZqaXhHRFlVeWltbkpzUV9mLWVCSlEyTks4cjNDNUV4cUVmbTY3cDdGSENIU2g4ZlhWd0lfQnJNcU1uZ0dWYUxXQldJX2RERmVaTjF6V3BEZmZtellnbDN1MFJaaEszU0RXN3BLVTNaWWV6UzhfLUk2Y2w3OExaVU5BLVZoZTlYeVgyT2JRdGZNY2JVM09PYktHb0sxX1ZWVGgyb0VRb3BrUGF1YUVwb01lZUZTMWhpOThhaHo2V0JCc2lTWFdEbnZoV0ZRTV9icUJjWElUam1raXFRMUZpX0tqSTJkQ1Z5SzNtU2N0MzY5bVJYNmw1b1ZKWTZVeVJvb3pBcS1zM1JabE80Z3VieEg1ZEJ1Y29yLVZSWl8xRVRzbnJTaDBrN3hMZWg2NFdPT2RCcURibTRHZ3BxbTQtYUZVZjMta2NOQXc3TDVjZFBxM0o1X3FuTEt0cUZIamZiWk1zVUtiVkZKNnNDdTlhS3VfcjRaMEh5UzB3MUZLUm00VmpoREczNl9tVFA3SXZNMmtqUUgzUmg4VkpUZHZkTl9LSENyTW1xSXV4QmQwMGJISmVpNTYwdURMTzM2SmRVY3gwVVN5X3FIWWFPckJzZmFpQ2VCMVVCX05ZclNZal9nVV8tNFpsdHZaR2RaMWJ3bWdHODdoR09hQ0lvLXM2dm1MZlZtelQ3dzlobVplT2kwS0NzQVEweUVkUl94WFFPSXVvVmIwWkhwZVlXalNnNWV6UTk0QnpmYzFlYjFGeGRBTVRTRmxpLUcteEhfX1A5QnA5T25CSnZDYzFtaVlINHBsOUwzYTg1MFhTZnd4WlF1akVVaE5WRVJOVTExT3hORzZ5ZkxSQmszVnFFSk1mS1ZoZmhqUGlyUkxnU3poYVVaT042UFZKZENYRnNHdnB1RGJpWW9SMEZSX1BlSVZoSVloRHloaGZOM3Qzd1NpVXZpWk5lWTRNQjdyVjhfZUwwdHJTRmczNjhXMUVqcXNkb3dhNEhVTlF2MFN0YXc2anVsandiN3IxUUxQTnpkM1hEaExnQmc4WGtmNUZuaXlWZnpuNm9Tb25uZDBWMnBJRWRRcnB6NDVQUkFUQVBfcHQxTjVEZldkcDc0RmVHMlFKQk5CZkJKNGdlaHpBXzhoM2NfZ3hBRlJfZ1d0a2dyMWwyd1pYeWo5dlplTXZHV3JYQzdzMmNzUXNnVUc1aEV4Sjd2NU9hZlVMcUg2Y2RHaXloTUZJOVlsZjZZTjdBMEp1T0NCemNMc1RjakcxU2xoMDhBTmRfRG00amNHbm5wVzVETVZrc3JqZGJWMWJQbnRHSkt5Ni04MVp6MkYxT3EyTzlFZUxUeDMwQU5naEJQOTF6bV9jUTVLZG85Ymc4YVRjWjBsQ0xEUmxwV2dGaW9sWHlIZmQxMWJGN1lFY2V6RlZvS080ZEl1S1JOOGQ0TU5IbVpjY1M4MkJxdHI5a0pDYzF0SVhnbUh5R0JudVV5ZGtkNS12MHBiVC1ybHpZdFh0ei0zTDBzeFZEdEFMMUY3Q0kwSlVpbV9KMEhPdm50b3p0d2dhTmp6d2VZT2FWalNmbWRUX2RsZ1hTWW1pWXk5QUJYUHVvSDZBdHV2MGlEbmVsdkVPMzFBV3hXTTAzVFVzd3hRVXdldHl5aDhhd2RDaXRTSlMyakJSZVRtZVZXMTA0d0lJVGNTdkxMcjRwbTVJNGt5SnVGMUxtamRhQVowd0VxY1E1R01UbXJxT2ZoZ2h0U0lOOVFaVDZWUktPbDVTdVlHZmllTk9GWGVVMjlRanVuRXkyRjFONzVEMWVkNERqT21iQ0tJYUVtNUFOZk5ETFdPWk5EaXNKcU1CeXl3eWlBMkhHZjBNNkE4cW5leFJRUGZqQWc4ZkQ1cjgwR3FtVmpyaXJFclA2SXRhVTE4blRTTFVWQmpqd3RpR0Vsb21jVHBycVdObnBfM21ZcUNaRkdPelNDYW5lQWlIOTcxYXhSclJ2eGJlb1Z4RVBTY01vOHlGd3lXeXBFN2RzeUZra1lHd0M1c21JYUpWMWI5UmJsdlIyUERNV0dvNjhuZVRtT0syU3djTkZURld0bnVrMkpqQjBuMWRoQV9DeEM2MVdNcGlGVzVrSUtXU3NFWk5qYncyRkNGSXVtZ0hYMDJRQkVuQ3h2WUkyUGplQ2lGY1pTMkhFeWpWSHkxdVU5RHVMOE9qMmczQjBoMjZFUTRmNG1IRVZESzA5a3k1c2owN1dqTE53S1ExR3FQazV1cXlEQlV4c2N3LmVjbFlZMXltenZ6OGdKTXVBaGtHaWc.NS_Gif9cQnQjKoD5q1UfKGYh3hp35DfY-7a4ujLqP7EUHPJ0cCpdiKCa1-CBzeelDTSOUezLJrqNsm9USMEHbv75OBEzJySL1XWRIOyKTvpnG5h8-vqWDPbpz6TzjEM4VH0mgnf4umfrUJ6i6K7QX0UvAM0b4m5HejeILLGFDEZHnW3XQuY4iEMamtTuzcmMSatoD9m5op3q1JXwinLAlaNKi3iZqUsF_9oCtZaPSqMSYhDlLWhFWHYg23QYNjpI9c28JXtBcq67LKMERjVSmU5IltZO_XyJQzHA4D_aQ2TmfDfNQ09xo76tqITh52Ae3F-sDAHbITqVJeCMjc_n9g
-
To decrypt the response, refer to: Process JWT Request with Keys
-
Refer to the sample response structure below. You may also check the API specifications here: FX Rate List Inquiry Response Parameters
<FxRateListResponse>
<version>2.1</version>
<timeStamp>070222084011</timeStamp>
<merchantID>JT</merchantID>
<baseCurrency>702</baseCurrency>
<currencyList>
<currency currencyCode="USD" fxRate="36.3156680" />
<currency currencyCode="GBP" fxRate="46.7764640" />
<currency currencyCode="EUR" fxRate="41.4787940" />
<currency currencyCode="JPY" fxRate="0.3154496" />
<currency currencyCode="HKD" fxRate="4.6221470" />
<currency currencyCode="MYR" fxRate="8.6752850" />
<currency currencyCode="SGD" fxRate="26.1435810" />
<currency currencyCode="BND" fxRate="25.3951800" />
<currency currencyCode="CNY" fxRate="5.1939590" />
<currency currencyCode="IDR" fxRate="0.0022940" />
<currency currencyCode="SAR" fxRate="7.9941560" />
<currency currencyCode="INR" fxRate="0.4720779" />
<currency currencyCode="KRW" fxRate="0.0295997" />
<currency currencyCode="LAK" fxRate="0.0039130" />
<currency currencyCode="PHP" fxRate="0.5493880" />
<currency currencyCode="TWD" fxRate="1.0539280" />
<currency currencyCode="AUD" fxRate="25.4764670" />
<currency currencyCode="NZD" fxRate="23.3994440" />
<currency currencyCode="CHF" fxRate="36.3493040" />
<currency currencyCode="DKK" fxRate="5.5555460" />
<currency currencyCode="NOK" fxRate="4.3782860" />
<currency currencyCode="SEK" fxRate="3.9886690" />
<currency currencyCode="CAD" fxRate="28.0664390" />
<currency currencyCode="RUB" fxRate="0.4148440" />
<currency currencyCode="VND" fxRate="0.0012782" />
<currency currencyCode="ZAR" fxRate="2.0630080" />
<currency currencyCode="AED" fxRate="8.1399120" />
<currency currencyCode="BHD" fxRate="70.3889360" />
<currency currencyCode="OMR" fxRate="69.3125840" />
</currencyList>
<responseCode>00</responseCode>
<respReason>Success</respReason>
</FxRateListResponse>
Updated 3 months ago